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SYSTEM CALLS AND I/O REQUESTS FOR THE CDC 7600 


1. INTRODUCTION TO SYSTEM CALLS 


1.1. General Information 


A system call is a request by a problem program for some 
function or service to be performed by FLOE or by EEA (the 
resident executive program.) The functions available include 
accessing files, communicating with terminal devices and with 
controllers and controllees, obtaining system tables and 
information, etc. 


You initiate a system call by storing certain information in 
the first word of your problem program (word zero) and performing 
an exchange jump (see Ref. 1). (An exchange jump is a 7600 
instruction that allows the CPU to switch execution from one 
program to another: see LTSS-1 Sec. 3.10.) “he problem program 
executes a normal exchange exit and FLOE (or EEA) gets control. 
Thus the contents of all machine registers are preserved for any 
system call, regardless of the number of calls in queue for a given 


problem program (see Sec. 1.4 on chained system calls.) There are no 


restrictions on the frequency or number of system calls a problem 
program can issue, except for call 04 (This Problem Program is 
Finished). Charges for a system call are levied based on the 
number of machine cycles required to complete the call. 


The general method of issuing system calls is as follows. 
You place information about the call in word zero of your problem 
program. One of the things you store in word zero is the address 
of another word, alpha, that contains further information 
specifying the nature of the system call. In most cases alpha 
contains a pointer to another word, beta, which is the first word 
in an array. The beta array is used either by you (to provide 
further information required for the call), or by FLOE (to return 
requested information or error indications), or both. 


1.2. Formats 


In order to issue a system call you must set up word zero of 
your problem program in the format shown below (examples of how 
to do this appear in Sec. 1.3). Upon completion of the 


system call, FLOE sets word zero to 0. 
Word zero: 000cc cecce tttta aaaaa 
where: ccececece is used only for chained system 


calls; ceccecee is O for normal 
(nonchained) system calls. (See 
Sec. 1.4 below.) 


titt indicates the type of call. If 
tttt = 1004 or 1005, FLOE 
processes the call; otherwise 
EEA processes it. The value of 
tttt you use will depend on the 
service you want performed. For 
calls to FLOE the value of tttt 
determines where control goes on 
completion of the call (see word 
alpha, below). 


aaaaaa is the address of word 
alpha for calls to FLOE. For 
calls to EEA (tttt .NE. 1004 or 
1005) the meaning of aaaaaa 
varies. See the individual 
calls. You may locate word 
alpha anywhere in small core 
memory or large core memory (SCM 
or LCM), as long as the address 
aaaaaa does not contain more 
than 18 bits. 


Word alpha contains information to further define the service(s) 
required from FLOE. You set up word alpha in the following 
format (see Sec. 1.3 for examples): 


Word alpha: ecnnr eturn xxxxb bbbbb 


where: cc is a code number that determines 
which of the 28 calls to FLOE 
you are making. Presently cc can 
have any value from 01 to 34 
octal. 


nn is certain information required 
for the call; usually the value 
of nn determines which of 
several options is desired. 


return is an address. Control resumes 
at “return” if the call is NOT 
successfully completed. The 
value of tttt in word zero 
determines the location at which 
control resumes for successful 
completion as follows: 


<2 


tttt=1004 Contro] resumes at (return + 1). 

tttt=1005 Control resumes at the location 
following the one from which the 
exchange was issued. 


XXXX is certain information required 
for the call. The meaning of 
xxxx differs for different 
calls. 


bbbbbb is the address of another word, 
beta, that is the first word in 
an array. You may be required 
to supply additional information 
to FLOE in the beta words, or 
FLOE may use the beta words to 
return requested information. 
You may usually locate the beta 
words anywhere in SCM or LCM, as 
you desire. <A certain few calls 
require beta in SCM. The format 
of the beta words is described 
with each individual call. 


FLOE examines all addresses specified in a system call for 
out-of—-bounds references; this includes aaaaaa, bbbbbb, ccccccc, 
and “return”. If any address is out of bounds, a fatal error 
results (see Sec. 6.2.1). 


Note that alpha and beta are not required to be in the same 
memory. Some programmers commonly locate alpha in SCM and beta in 
LCM. 


1.3. Examples of How to Issue a System Call 


In this section we show in detail two ways of issuing a 
system call in a Fortran program. In the first method (the hard 
way) you must load word zero, word alpha, and the beta word(s) 
with the exact bit structure required to define the service you 
want FLOE to perform; in addition you must issue an exchange 
jump. The second method (the easy way) exploits ORDERLIB 
subroutines (see Ref. 2) to do the bit-and-byte manipulations 
required to issue the call. 


The specific example we consider is a system call to create 
a disk file named FILENAME, with a length of 10000 (octal) words 
(see the Create call, Sec. 2.1). If a file by this name already 
exists, it is to be destroyed. The file is to be referred to in the 
program as "logical unit 7" (actually, the number of an I10C, or 
input/output connector: see Sec. 4.2). See Sec. 2.1 for details 
about the Create system call. 


The Hard Way. Figure 1 shows the Fortran coding necessary 
to issue this sytem call the hard way. The first thing that is 
necessary is to provide access to word zero of the problem 
program. the ABSOLUTE statement in LRLTRAN allows us to specify 
that the variable ZERO is stored in absolute location zero 
("absolute”" is actually a misnomer, since the first word of the 
program is not word 0 of memory, but is a “relative” word zero). 
Another way to access word zero of the program, if your program 
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is loaded by LOD, is to include the statement 
COMMON / GOBCOM / ZERO 


The common block GOBCOM is located at the beginning of al] 
programs loaded by LOD. 


In this example BETA is a 15-word array; the beta array may 
need to be larger for some system calls. 


Numbers to be OR’ed 


Line for words zero, alpha,,. 
No. Fortran coding and beta Word 
1 ALL INTEGER 
2 ABSOLUTE ZERO (0) 
3 DIMENSION BETA (15) 
4 ZERO = (1005B .SHL. 18) 00000 00000 10050 00000 ZERO 
5 1.UN. (.LOC. ALPHA) a aaaaa ZERO 
6 ALPHA = (101B .SHL. 48) 01010 00000 00000 00000 ALPHA 
7 1.UN. ( (.LOC. ERCRE) .SHL. 30) e rerea ALPHA 
8 2.UN. (11B .SHL. 18) 11 ALPHA 
9 3.UN. (.LOC. BETA) b bbbbb ALPHA 
10 BETA = BRFILENAME 
11 BETA (2) = (7B .SHL. 54) 07000 00000 00000 00000 BETA 
12 1.UN. (10000B) 10000 BETA 


13 CALL Q8EXCH 
(continuation of coding) 


50 ERCRE (coding for error processing) 


Fig. 1. Fortran coding necessary to issue a Create call the hard 
way. The column on the right indicates how the words 
ZERO, ALPHA, and BETA are built by the logical union 
of elements. 


In lines 4 and 5 of the figure, word zero is constructed. 
Note that the value of 1005 for tttt means that control resumes 
at the location following line 13 (CALL Q8EXCH) if the call is 
successfully completed (and at the statement labeled ERCRE in 
case of error). The right-hand column in Fig. 1 indicates how 
ZERO is built from the logical union of the entities in lines 4 
and 5. 


Word ALPHA is constructed in lines 6 to 9. The first four 
octal digits in ALPHA are 0101, indicating that one file is to be 
created using the Create system cal] (call 01). Following these 
digits is the location of the statement labeled ERCRE 
(represented by ercre in the figure). The 11 option (line 8) 
tells FLOE to destroy a file by the same name, if such a file 
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exists, before creating the new file. Finally, the last six 
octal digits in ALPHA are the address of the array BETA. 


In Jines 10 to 12 the BETA array is filled in; only the 
first two words of BETA are needed. The 07 in line 11 means that 
the file FILENAME wil] be referred to in the program as logical 
unit 7 (i.e., FELENAME will be associated with input-output 
connector, or I[OC, number 7). Line 12 specifies the length of 
the file. 


The CALL Q8EXCH statement creates the machine instruction 
for an exchange jump to EEA. This instruction is executed (line 
13), and FLOE takes control. After the system call is 
successfully completed, contro! resumes at the statement 
following line 13. Control resumes at ERCRE if any system-cal] 
error occurs. 


The Easy Way. A number of subroutines are available that 
simplify issuing system calls and !/O requests. These 
subroutines, available in the ORDERLIB library text (Ref. 2), 
are described in Ref. 4. In brief, FROSTCALL is a 
multiple-entry-point subroutine that can be used to issue calls to 
FLOE. FROSTIO can be used for 1/0 requests. FROSTCLICHE is a cliche 
that you can employ in your code; it defines various 
mnemonics to be used with the two routines. 


Figure 2 shows how much simpler issuing our Create cal] 
becomes when we use ACCESS (an entry point in FROSTCALL). The 
COMMON statement, line 1, is not actually necessary for this call 
but is needed for certain other calls issued using FROSTCALL. 

The call to ACCESS in line 2 does all the work for us. The value 
of 1 in the first argument means we want to issue the 01 call to 
FLOE (Create). The third argument means that FILENAME is to be 
logical unit 7 (10C number 7), while the value of zero in the 
next argument specifies that a disk file (as opposed to a tape) 
is to be created. 


No. Fortran coding 

1 COMMON / FROSTCOM / —INTEGER-— ALPHA, 

2 1BETA(15) 

3 CALL ACCESS (1, 8RFILENAME, 7, 0, 10000B, 
4 


1ERCRE) 


(continuation of coding) 


50 ERCRE (coding for error processing) 


Fig. 2. Fortran coding to issue a Create s: stem call the easy 
way, using the entry point ACCESS to the ORDERLIB 
routine FROSTCALL. 


1.4. Chained System Calls 


FLOE system calls can be chained ~- that is, an arbitrary 
number of calls can be performed sequentially before control] is 
returned to the program issuing the calls. A chain of calls is 
initiated by setting up word zero with a nonzero c field: 


Word zero: 000cc ccecce tttta aaaaa 


where: ccccecce is the address of the next "zero 
word" in the chain (19 bits 
maximum). Zero words of calls 
following the first call in a 
chain can be located anywhere in 
memory, except at location O of 
the program. 


Calls in a chain are executed in order until an error occurs, or 
until a cal] with a zero c field is encountered. If all calls 
are completed successfully, control resumes at the location 
"return + 1" specified in the last call in the chain, or at the 
next location in the program (depending on tttt). In case of an 
error return on any call in the chain, the processing of the 


chain is terminated and control resumes at the “return” address 
of the bad call. 


vs 


2.1. Call 01: Create 


CALLS TO FLOE 


This call (1) reserves space on disk for a hitherto 
nonexistent set of files, (2) reserves input and output units 
other than disk and teletypewriter for use by this program, and 
(3) provides system services for a problem-program drop file. 


Format: 


Word zero: 00000 00000 


where: aaaaaa 


is the address of word alpha. 


Word alpha: Olnnr eturn ccddb bbbbb 


where: O1 


nn 

return 

ce 

dd 
dd=00 
dd=01 
dd=02 
dd=03 
dd=11 

bbbbbb 


is the code for Create. 


is the number of reservation requests 
(nn .LE. 16). 


is the retuin address (see Sec. 1.2). 


is the notify option for tape 
creates. If ce .GT. 00 and all 
tape drives are assigned, the ss 
field in word beta is set (see 
below) and control resumes at 
return. 


indicates which option is desired: 


Normal create. 

Drop-file request (destroy duplicate 
file option). 

Drop-file request (do not destroy 
duplicate file option). 

Create under another user number (only 
user-1 can use this option). 

Create file but destroy existing 
duplicate file. 


is the address of the first word, beta, 
of the nn reservation requests. 


Definition: The term “user-1" is jargon for a 
system of problems programs recognized by FLOE 
as privileged extensions of itself. The term 


comes from "user minus 1, 


or user number 


999999, which was the original number under 
which these programs were run; there are now 
several “user—-1" numbers. These programs are 


executed by FLOE when 


it detects a need to run 


them to process HSP output tape, punched-card 
output tape, dd80 output tape, microfilm output 


tapes, file transport, 


functions. 


printer, or card reader 


1004a aaaaa or 00000 00000 1005a aaaaa 


Word beta: The name of the disk file or the tape-vault 
(dd = 00, 11) number (ASCI1), right-justified). For 
disk files, the name may be up to 10 
characters long, and for tape-vault 
numbers up to 6 characters. If dd = 11 
and a file having the given name already 
exists, the existing copy is destroyed 
and the new file is created as specified, 
if possible. If the new file could not be 
created, the existing copy is not 


destroyed. 
Word beta + 1: mmsst tuuxx | lwww wwwww 
(dd = 00,11) 
where: mm is the IOC word designation for this 
file. 
ss is filled in (by FLOE) on completion 


of the system call. as follows: 


ss=00 Normal completion. 

ss=01 Name duplication, or name not in file 
index. 

ss=02 Not enough space. 

ss=03 Access denied. 

ss=04 Format or parameter error. 

ss=05 Operator-initiated tape error (tape 
not in vault). 

ss=06 10C word already in use. 

ss=07 File index or disk trouble. 

ss=10 Access code out of range. 

ss=11 No tape drives available. 

ss=12 File already exists (dd = 02). 

ss=13 FLOE cannot destroy the existing file 


(dd = 01,11). 
ss=14 Drop-file length less than 231 octal 
(dd = 02). 


ss=15 Unable to send tape-request message to 
operator teletypewriter. 
ss=16 File name requested is the same as the 
name of a public or political 
file (occurs only for dd = 03: 
user-1 creating a file under 
another user number). 
ss=20 Device not available. 
ss=21 Online printer unavailable (user-1 only). 
ss=22 dd80A reserve-reject. 
ss=23 dd80A not ready. 


tt is the type of unit: 


tt=00 Disk. 

tt=01 Seven-track tape. 

tt=02 Nine-track tape. 

tt=04  PDP-10 (user-1 only). 

tt=05 Card reader (user-1 only). 
tt=06 Line printer (user-1 only). 
tt=07 Drum. * 

tt=11 dd80A. 


If tt = 00 then uu specifies the disk unit (1 through 24 
(octal)) on which this file is to reside. 
If the requested disk is full, 
or if uu = 00, the file is 
assigned to the first disk unit 
that has space available. Upon 
completion of this call, uu 
indicates the disk unit (1 
through 14 (octal)) on which the file 
was actually created. (This may 
be different than that 
originally specified.) 


If tt = O1 or tt = 02 then uu specifies the logical tape unit (00 
through 47) to which the operator 
assigned the tape. 


XX Specifies file type. 
xx=03 File is type data. 
xx=05 File is execute-only drop file 
(dd = 01,02). 
1] is the protection level. 
WWWWWWWww is the word length for this 


file. This length is examined 
if and only if tt = 00 (i.e., 


disk). 
Word beta: The name of the drop file. For dd = O01, if the 
(dd = 01,02) new drop file can be created as specified, and there 


is already a file by the given name, the 
existing file is destroyed. If the new 
file cannot be created, the existing copy 
is not destroyed. For dd = 02, if a file 
of the specified name exists, FLOE 
transfers control to the error return. 

If beta = 00, FLOE generates a 
recognizable and unique ASC]! name. 


Word beta + i: The length at which the drop file is to be created 
(dd = 01,02) (at least 231 octal). If beta + 1 is zero, FLOE 
generates a length sufficient to contain 
the calling program. If xx .NE. 5, drop 
file is read-write; if xx = 5, drop file 
is execute-only, but system can write 


into it. 
Word beta + 2: Binary user number. 
(dd = 03) 
Remarks: 


1. nn is assumed to equal 01 if dd = 01 or O02. 
2. If dd = 00, the error return is taken if ss .GT. 0, and !10C 
words are not set. 
3. For tt = 01 or tt = 02, the six-character tape-vault number is typed 
*) The drum is read-write for user-1 and users logged in at the 
teletypewriter at protection level k-1, and read-only for all 
other users. 


on the operator’s teletypewriter. The operator locates 
the requested tape and makes it available to the system. 
If the first, i.e., leftmost, character of the 
tape-vault number is an asterisk (*) or a plus (+). the 
operator will mount a blank write-enabled tape. The 
plus (+) indicates a purple reel is to be used. 
If dd = 00, the beta words come in groups of two. Thus, word 
beta + 2 has the same format as word beta, and beta + 3 
has the same format as word beta + 1. There are (2*nn) 
beta words in all. 
If dd = 01 or 02, the user may specify a disk unit for the 
drop file as for any other create. No IOC word is 
filled in, as none is required. For any variable not 
specified, the system completes the appropriate beta or 
beta + 1 word with the data it has generated. Hence, if 
no mame is given, the system places the generated hash 
name in beta. If no length is given, the generated 
length is placed in beta + 1. Any combination of name 
and length or their nulls may be given. If the system 
generates a name, it wil] use the original file name 
prefixed with an ASCII +. A random character will be 
generated in the low order character position until the 
name is unique. The name of the calling program is 
changed to the drop-file name. 
Creates are processed in the following order, regardless of the 
order in which they are issued: 

1. Tapes; 

2. Other nondisk equipment; 

3. Disk files. 
If the protection level field (11) is zero, the file is created 
with a protection level equal to that of the calling program. 
A file cannot be created via the card reader if it has 
the same name as a system public or user public file. 
If a problem-program controllee of another problem 
program issues a Tape-Create call specifying an IOC that 
is being used as a tape-sharing IOC (because of a 
Give-Tape-Access call] by its controller), the create is 
successful, but the ss field is set equal to 4 and the 
error return is taken as a warning that the shared tape 
is no longer available. 
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2.2. Call 02: Destroy 


This call allows the problem program to give up disk files and to 
release input/output devices (other than disk or teletypewriter). In the 
case of giving up disk space, the disk space presently being occupied by 
the specified set of files is given back to the system for reassignment. * 


In addition to releasing the specified items, this call makes it impossible 
for the requesting problem program to communicate with them. 


Format : 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha O2nnr eturn wwvvb bbbbb 
where: 02 is the code for Destroy. 
nn is the number of destroy requests 
(nn .LE. 16). 
return is the return address (see Sec. 1.2). 
bbbbbb is the address of the first word, beta, 
of the nn requests. 
ww = 1 means make a disk-flaw entry 
(user-1 only). 
ww = 2 means destroy another user’s file 
(user-1 only). 
VV -NE. 9 means destroy a file that is 
not open 
Word beta: The name of the disk file or the tape—vault 
number (ASCII, right-justified). 
Word beta + 1: mmsst t0000 00000 00000 (ignored if vv .NE. 0) 
(ww .NE. 2) 
Word beta + 1: mmsst t0000 O00uu uuuuU 
where: mm is the 10C word for th is file. 
ss is filled in (by FLOE) on completion 
of the system call, as follows: 
ss=00 Normal completion. 
ss=01 Name not in the file index. 
ss=02 The file is opened more than once by the 


calling program, or some other problem 
program has it opened. (The file is not 
destroyed.) 

ss=03 The destroy was not accomplished (wrong 


*) Compare Close, Sec. 2.19. 


Remarks: 


10C word or name). 


ss=04 Format or parameter error. 

ss=05 Access denied (ww = 02, not user-1). 

ss=06 Tape—-destroy error (wrong name, or void). 
ss=07 Disk-map trouble (the file is not destroyed). 
ss=10 No such user (ww = 01). 


ss=12 User had no files (ww = 02). 
tt is the type of file. 


tt=00 Disk. 

tt=01 Any 1/2-in. tape. 

tt=02 Any 1/2-in. tape. 

tt=04 PDP-10 (user-1 only). 

tt=05 Card reader (user-1 only). 
tt=06 Line printer (user-1 only). 
tt=11 dd80A. 


uu is the binary user number. 


The beta words come in groups of two. Thus beta + 2 has the 
same format as word beta, and beta + 3 has the same format as 
beta + 1. There are 2*nn beta wor::; in all. 

If ss .GT. 00 the error return is taken, and the IOC words are 
not erased. 


Z.5: Coll 03; 


Open 


This call makes it possible for the requesting problem program to 
communicate with a disk file (or set of disk files) that has been 
previously created* by the user or is otherwise accessible by him. 


Format: 


Word zero: 


where: 
Word alpha: 


where: 


Word beta: 
(ww = 00,03) 


Word beta + 1: 
(ww = 00) 


where: 


00000 00000 1004a 
00000 00000 1005a 


aaaaaa is the 


O3nnr eturn ww00b 


aaaaa or 
aaaaa 


address of word alpha. 


bbbbb 


03 is the code for Open. 

nn is the number of files requested 
(nn .LE. 16). 

return is the return address (see Sec. 1.2). 

ww indicates which option is desired (ww = 00, 
01, 02, 03, or 04)-—-see below. 

bbbbbb is the address of the first word, beta, of 
the nn requests. 


The name of the disk file (ASCII, right-justified). 


mmssp auurr tlzzz 


mm is the 


ZZZZZ 


10C designator. 


ss is filled in (by FLOE) on completion of 
the system call, as follows: 


ss=00 Normal completion (read-write file). 

ss=01 No name was given, or the given name is not 
in the file index. 

ss=02 Normal completion (read-only file). 

ss=03 Improper IOC word. 

ss=04 10C word is already in use. 

ss=05 Access is denied. 

ss=06 The potential file-transport user doesn’t 
exist. 

ss=07 Drum-file index is now being searched for 
this file. 

ss=10 Tried to open an execute-only file, or 


change to an illegal type. 


indicates whether the file is public or 


private (filled in by FLOE): 


Pp 
p 


*) Compare Create. Sec. 2.1. 


0 Private file. 
1 Public file. 


-13- 


p=2 Political file. 


a a.NE.O Means file is already open (active) by this 
or some other program. 


uu is filled in (by FLOE) with the number of 
the disk unit (1 through 24(octal)) on which the 
opened file resides. 


rr specifies the file-protection status. FLOE 
opens the file and sets its type to: 


rr=00 No change from existing status. 
rr=01 Read-write. 

rr=02 Read-only. 

rr=03 Data. 


t is filled in (by FLOE) with the 
protection status of the file, as follows: 


t=1 Read-write. 
t=2 Read-only. 
t=3 Data. 
l is filled in (by FLOE) with the protection 
level: 
l= Not classified. 
1=1 Unclassified. 
l= PARD (Protect As Restricted Data). 
=3 ADP, or official use only. 
l= Confidential. 
=5 Secret. 
=6 (Reserved. ) 
=7 System. 
ZZZZZLZZ is filled in (by FLOE) with the number 
of words in the opened file. 
Word beta: The name of the disk file (ASCII, right—justified) 
(ww = 01) 
Word beta + ! mmssp auurr tlzzz zzzzz 
(ww = 01) 
Same as for ww = 00. 
Word beta + 2: 00000 00000 Omiff frfff 
(ww = 01) 
m If m is not equal to 0, a write-—IOD 
has been issued to this file. 
frfrrrfff Filled in (by FLOE) with the length at 


which the file is to be loaded into the LCM 
upon the first load.* 


*) See Close call, Sec. 2.19. 


Word beta: The name of the disk file (ASCII, right—justified 
(ww = 02) 


Word beta + 1: mmssp auurr tlbbb bbbbb 
(ww = 02) 
where: mm, ss, Pp, 
a, uu, rr, are all the same as for ww = 00. 
t, | 
bbbbbbbb specifies the binary user number of the 


file’s owner. The field is overwritten by 
FLOE with the file length. 


Word beta + 2: 00000 aaaaa Omfff fffff 
(ww = 02) 
where: aaaaa is three 5-bit display-code characters 


representing the alpha account 
designator liable for any changes 
against the file. 


m if m is not equal to 0, a write IOD 
has been issued to this file. 


iffrfrfrff is filled in (by FLOE) with the 
length at which the file is to be 
loaded into the LCM upon first load. 


Word beta: is the same as for ww = 00. 
(ww = 03) 
Word beta + 1: is the same as for ww = 02, except the ss field is 
(ww = 03) set to 1 if active 10C count for this file is 
not zero. 
Word beta + 2: is the same as for ww = 02. 
(ww = 03) 
Word beta: is the same as for ww = 00. 
(ww = 04) 
Word beta + 1: is the same as for ww = OO. 
(ww = 04) 
Word beta + 2: Oooot ttttt ttrff ffriff 
(ww = 04) 
where: tttttttt is filled in (by FLOE) with the 


time last referenced (microsecond 
clock shifted right by 24 bits). 


frf°rfrryrf is the first-word address of a sector in which 
a fatal parity or positioning error occurred 
(returned by FLOE). 


Remarks: 


1. The beta words come in groups of two for ww = 00. For ww .NE. 0, 
the beta words come in groups of three. 
2. The options ww = 02, 03, 04 are restricted to user—-1! (system) only. 
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3. For ss=01 and ss .GT. 02, the error return is taken, and the 
10C words are not set. For ss = 0O and ss = 02 the normal 
return is taken and the JOC words are set. 
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2.4. Call 04: This Problem Program is Finished 


This call indicates that this problem program has run to its norma] 
termination point. The requesting problem program will not receive any more 
computer time. As soon as all messages originated by it have been delivered 
to its controller, the problem program is disconnected from the system. 


Format: 

Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 

Word alpha: O4ddr esume 00000 00000 
where: 04 is the code for this system call. 


dd indicates whether the problem program 
is to be saved: 


dd=00 Erase the problem program from core but 
preserve its final state in its disk file. 
dd=01 Erase the problem program from core and disk. 


resume is the address at which the PP will] start 
if it is to be used again. (This feature 
may be used to automatically initialize 
a service program.) 


Remarks: 

1. This requesting problem program is removed from central memory and 
stored under its executing name in the user’s file index. The, last 
message previously sent by the problem program is transmitted to the 
controller when the controller logs in. When the message 
transmission terminates, ALL DONE is transmitted and the done 
sequence is initiated. Control is not returned to the problem 
program. The ALL DONE message, in octal, is: 


407777004 15454004457 
56454077774002040000 


beta 
beta + 1 
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2.5. Call O5: 


Give Files to Other Users 


This call makes it possible for one user to give data or programs 
to another user. 


Format: 

Word zero: 
where: 

Word alpha: 


where: 


Word beta: 
Word beta + 1: 


where: 


Remarks: 


aaaaa 


nn 


return 


bbbbbb 


ss 


xx 


00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 


is the address of word alpha. 


O5nnr eturn 0000b bbbbb 


is the code for Give Files. 


is the number of files to be given 
(nn .LE. 16). 


is the return address (see Sec. 1.2). 


is the address of the first word, beta, of the 
nn requests. 


The name of the disk file (ASCII, right-—justified). 


00ssO OOOxx xxxxx xXXXxx 


is filled in (by FLOE) on completion of 
the system call, as follows: 


Normal completion. 

File already exists. 

This is a public file name. (A user 

cannot give a file with vhe same name as that 
of a public file.) 

File does not exist. 

Incorrect format for user number xx ... x. 
User number xx . . . x is invalid. 

The file going to user~1 does not have a 
legitimate output file name. 

There are outstanding IOC’s against 

this file, so it cannot be given. 

User number xx .. . x does not have a high 
enough access control level, or is not a poo} 
boss. 

Trying to give an execute-only file to user-1. 


is the (ASCII) user number to which the 
file is to be given. 


1. The beta words come in groups of two. Thus, word beta + 2 has the 
same format as word beta, and word beta + 3 has the same format as 

There are (2 * nn) beta words in all. 

-GT. 00 the error return is taken. 

3. Files scheduled for RJET output should be given to user 


word beta + 1. 
2% If ss 


number 000002. 
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2.6. Call 06: Send a Message to or from a Control Teletypewriter 


By means of this cal!, brief messages may be sent to the operator, 
giving directions, additional information, or opinions. A message may also 
be sent back to a user terminal (user—1 only). 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: O6nnr eturn OOmmb bbbbb 
where: 06 is the code for this system call. 
nn indicates the control teletypewriter desired: 
nn=00 is the operator’s console teletypewriter. 
nn=01 is the card-reader teletypewriter (user-1 
only). 
nn=02 is the user terminal (user-1 only). 
return is the return address (see Sec. 1.2). 
mm is the number of main-—frame words containing 
the message (mm .LE. 8). 
bbbbbb is the address of word beta, whose format 
is described below. 
Word beta: The first word of the mm words containing the message. 
(nn = 00,01) 
Word beta: Binary user number of the user receiving the message. 
(nn = 02) 
Word beta + 1: The first word of the mm words containing the message. 
(nn = 02) 
Remarks: 
1. The error return is taken if mm = 00 or if mm .GT. 08. 


2. For nn = 02 the beta buffer must be in SCM. 
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2.7. Call 07: Get a System Table 


This call allows a user to get various file indices, user directory 
information, and certain system tables. 


Format: 


Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 


where: aaaaaa 


is the address of word alpha. 


Word alpha: O7nnr eturn mmmmb bbbbb 
where: 07 is the code for this system cal]. 
nn indicates which option is desired: 
nn=00 Get the public file index. 
nn=01 Get the private file index. 
nn=02 Get the currently active user numbers. 
nn=03 Get the active user directory and repository 
table entries for the requester’s repository 
group. 
nn=04 List the IC2’s of the problem program. 
nn=05 Return count of users files in the mmmm 
field. 
nn=06 Get the pool file index(s) that the user 
currently has active. 
nn=10 List a FLOE system table. (Beta must 
be in SCM.) 
nn=11 Is the same as nn .NE. 01 except as 
noted under word beta + 1. 
nn=12 Same as nn = O01 except as noted under 
word beta + 2 
nn=13 Means get the active user directory and reposi- 
tory table entries for all repository groups. 
nn=14 Same as nn = 11 except as noted under word 
beta + 2. 
return is the return address (see Sec. 1.2). 
mmmm is the maximum number of files, user 
numbers, or I0C’s. The buffer length 
must be at least (2 * mmmm) for nn = 03, 
(4 * mmmm) for nn = 03 and 13, and (3 * mmmm) 
for nn = 04. Not used for nn = 10. 
bbbbbb is the address of the first word, beta, of 
the buffer. 
Word beta: The name of the disk file (ASCII, right-justified) 
(nn = 00,01,06) filled in by FLOE. If the user has put a single, 
left-justified ASCII character in the first beta 
word, only those file names comprised of 10 characters 
and beginning with the specified character are listed. 
The first beta word is overwritten. 
Word beta + 1: ptqql ddddd ddzzz zzzzz 


(nn = 00,01,06) 
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where: 
Word beta: 
(nn = 02) 
Word beta + 1: 
(nn = 02) 
Word beta: 
(nn = 03) 
where: 


Word beta + 1: 
(nn = 03) 


where: 


P 


qq 


ddddddd 


ZZZZZZ2ZZ 


vUuUUYV 


ano 


(aa nell nal nel mal 
Hou nd ue a 


Om WM = 


specifies the domain in which the file exists: 


Private file. 
Public file. 
Political file. 
Pool file. 


is filled in (by FLOE) with the protection 
status of the file. 


Read-write. 

Read-only. 

Data. 

Execute-only. 
Execute-only drop file. 


is a 6-bit field expandable to fuuuuu. 


is a completion bit filled in (by FLOE) 
for a file that exists as a result of a 
file-transport job. 


The file is in transit, or this is not a 
file-transport job. 
The entire “.le has been received. 


is the disk unit (1 through 24 (octal)) on 
which the file resides. 


is the protection level of the file. (See 
Open call Sec. 2.3). 


is filled in (by FLOE) with the time last 
referenced (microsecond clock shifted right 


24 bits). 


is filled in (by FLOE) with the number 
of words in the file. 


The user number (ASCII, right-justified), 


filled 


in by FLOE. 


The user claimed time (integer microseconds), filled 
in by FLOE. 


0000p ppppp ppppp ppppp (user directory) or 


Begee giiii iiiii iiiii (repository) 


PPPPPpPppppppppp is the file pool keys. 


&beeE 


ii 


ddddddd 


is the ASCII group code. 


is the repository group initial time (micro- 
seconds). 


ddddd ddeee eeeee eeeee (user directory) or 
vvvvv vrrrr rrrrrorrrrr (repository) 


is the user ID number (binary). 
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Word beta + 2: 


(nn = 03) 


where: 


Word beta + 3: 


1: 


3: 


(nn = 03) 
where: 
Word beta: 
(nn = 04) 
Word beta + 
(nn = 04) 
Word beta + 
(nn = 04) 
Word beta + 
(nn = 04) 
Word beta: 
(nn = 10) 


ee 


VV 


rr 


ff 


ec 


iiii 


eee 


Ppp 
hhhh 


is the current tota! priority-—weighted 
charged time (microseconds). 


is the ASCII overhead account designator. 


is the remaining repository group time (micro— 
seconds). 


ooooo OOfff fffff fffff (user directory) or 
00000 Ocece ecccce ccece (repository) 


f 


- c 


is the current claimed time (microseconds). 


is the repository group committed time 
(microseconds). 


iiii0 O00gg ggppp hhhhO (user directory) or 
00000 00000 00000 00000 (repository) 


is the entry in the 


(IUD) table. 


inactive user directory 


is the maximum percentage charge against 

the group repository that is allowed to this 
user. The user’s available charge time is: 
0.001 * gggg * (repository group’s initial 
time) minutes. 


is a pointer to the user’s repository entry. 


is the number of disk files owned by this 
user. 


Filled in by FLOE; the first word of IOC 
number Q. 
Filled in by FLOE; the second word of 10C 
number 0. 
Filled in by FLOE; the third word of IOC 
numbered 0. 
Filled in by FLOE; the first word of I10C 


number 1, etc.* 


The name of the FLOE table desired (ASCII, 


right-justified). 
first table entry. 


FLOE overwrites beta with the 
The list of acceptable table 


names follows (values for length are decimal): 


DMAP 
MISCTB 
CORTAB 


descriptor block table (length = 3048) 
user table (length = 2048) 

file index table (length = 20226) 

disk map table (length = 3072) 
miscellaneous table (length = 192) 


device correspondence table (length = 72) 


*) See Appendix C for input/output connector format. 
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Word beta + 1: 


Word beta + 1: 


Word beta + 2: 
12, 14) 


where: 


00000 00000 00001 


PAREC device parity-error table (length = 128) 

FLAW disk flaw table (length = 384) 

TPTB HSP, CRT, ddsO tape ID table 
length = 3) 

TTY logged—on teletypewriter table (length = 
512) 

LT memory reserve limits (length = 2) 

SY operating system number (length = 1) 

ALT alternator table (length = 60) 

OPARAM system operating-parameter table (length = 
24) 

DISF disk unit availability table (length = 
20) 

UD inactive user directory, active 


user directory table, and 
repository table (length = 4320; 
length IUD = 2496, UD = 1024, 
Repository = 800). 


11111 


where: J11/11 is the number of buffer words (beta words) 
available. FLOE will return the 
minimum of I1]1]111 or the table length. 
Same as for nn = O1, except the d field is 
filled in by FLOE with the time of 
origin of the file (microsecond clock 


shifted right 24 bits). 


aaaaa 


uuuuuUuUu 


The beta words 
nn = 10, 13). 

beta, and word 
There are (2 * 
beta words for 
The beta words 


12 or 


originating user number remain with a file when 


until 


all 


the recipient OPENS the file the first time. 
values are changed to the new owner’s numbers. 
not pertain when the recipient 
originating 


00000 000aa aaauu uuuuu 


is three 5-bit display code 
characters representing the alpha 
account designator liable for any 
charges against the file. (See 
Remark 5) 


is the binary user number of the 
originator of the file. (See 
Remark 5.) 


come in groups of two (except for nn = 03, 04, 
Thus, word beta + 2 has the same format as word 
beta + 3 has the same format as word beta + 1. 
mm) beta words for nn = 00, 01, and 02; and (4 * mm) 
nn = 03, 13, and (3 * mm) for nn = 04. 
come in groups of three for nn = 04. 


and 


Thus, word 


has the same format as word beta (but for IOC number 
There are (3 * mm) beta words in all. 

3 or 13, 
the maximum buffer space required is 1824 (decimal) words. 
10, beta must be 


the format of beta is shown in Fig. 3. For 


in SCM. 

14, note that the alpha account designator and the 
it is given away 
Then, both 
This remark does 
is a User-1 number, in which case 
identification remains with the file until it is 
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DESTROYED. 


For nn = 10, beta = UD: The inactive user directory table 

is a one-word-per-entry table defining a user number. If the 
upper-—order bit of an entry is on, the complete user directory is 
in the active user directory table. If this bit is 0, the 
complete entry is on disk in file SYSTEM. If I is the index 

into the IUD table, then the location of the UD on disk is 

740000 + (I — 1)*4. The maximum number of UD’s is 2500. 
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(max = 256 entries, 
4 words/entry) 


ASCII word] REPOSITORY 
3 i. 


4-word spacer 


Repository entries 
{max = 200 entries, 
4 words/entry) 


Fig. 3. Format of beta for nn=03 or 13, call 07. 
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2.8. Call 10: Give Tape Access to Controllee 


This call gives a controllee access to a tape created by its controller. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 10nnr eturn rr00b bbbbb 
where: 10 is the code for Give Tape Access. 
nn is the number of tapes to be given. 
return is the return address (see Sec. 1.2). 
rr determines controllee access to a contro! le- 
tape: 
rr=00 Means give access. 
rr=01 Means recall! access. 
bbbbbb is the address of the first word, beta, of 
the nn tape identifications. 
Word beta: Tape vault number (ASCII, right~justified). 
Word beta + 1: mmssO 00000 00000 00000 
where: mm is the IOC word for this tape. 
ss is filled in (by FLOE) on completion of 
the system call, as follows: 
ss=00 Normal completion. 
ss=01 Tape not defined. 
ss=02 Wrong 10C word. 
ss=03 The controllee already owns a private tape 
in the 10C specified by mm. 
ss=04 The controllee already owns the tape. 
Remarks: 
1. The beta words come in groups of two. Thus, word beta + 2 
has the same format as word beta, and word beta + 3 has the same 
format as word beta + 1. There are (2 * nn) beta words in all. 
2. For ss .GT. 00 the error return is taken. 
3. The controllee gains access to the tape through the same 10C 
number as the controller uses for that tape. The controllee 
is not allowed to destroy the tape; an ss = 06 destroy error wil] 
be returned if it tries (see Sec. 2.2). 
4. When a controller gives tape access to its controllee, each 


controllee initialized by that controller will have its appropriate 
IOC words filled in with the corresponding tape information 

(until the controller destroys the tape). The rr option allows 

the controller to manage access to its tapes. 
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2.9. Call 11: Change File Name, Program Name, Account Number 


This call allows a user to change the name of a file or program, or to 
change the account number being billed. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: linnr eturn 0000b bbbbb 
where: 11 is the code for this sytem call. 
nn indicates which option is desired: 
nn=00 Change file name. 
nn=01 Change problem name. 
nn=02 Change account number. 
nn=03 Remove program’s trusted status (no beta 
words). 
return is the return address (see Sec. 1.2). 
bbbbbb is the address of word beta. 
Word beta: Old file name (ASCII, right—justified). 
(nn = 00) 
Word beta + 1: New file name (ASCII, right-justified). 
(nn = 00) 
Word beta: New program name (ASCII, right-justified). 
(nn = 01) 
Word beta: ss000 000aa aaaaa aaaaa 
(nn = 02) 
where: aa...a is the new account number (ASCII, 
right-justified). 
ss is filled in (by FLOE) on completion of 
the system call, as follows: 
ss=00 Normal completion. 
ss=01 Illegitimate new account number. 
Remarks: 
1. The number of beta words varies with the option: two for 


nn = 00, one for nn = 01 or O2@. 

2. For nn = 00, the error return is taken if there is a name 
duplication, i.e., a file having the proposed name already exists. 
For nn = 01, the error return is taken if a disk file, having 
the same name as the proposed new program name, does not already 
exist. 
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2.10. Call 12: 


This call 


Format: 


Word zero: 


allows 


Cut Back File Length 


a user to shrink the size of a disk file. 


00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 


is the address of word alpha. 


12nnr eturn 0000b bbbbb 


is the code for this system call. 
indicates the option: 

The file is private. 

The file is another user’s file (only 


user-1 can employ this option). 


is the address of a word, beta, defining 
the file whose length is to be changed. 


Name of file (ASCII, right-justified). 


OOssu uuuuu u0zzz 2zz2zz 


where: aaaaaa 
Word alpha: 
where: 12 
nn 
nn=00 
nn=01 
bbbbbb 
Word beta: 
Word beta + 1: 
where: ss 
ss=00 
ss=01 
ss=02 
ss=03 
ss=04 
ss=05 
ss=06 
ZZZZZZLZZ 
uuuuuuU 
Remarks: 
1. The error return 


is not made. 


is filled in (by FLOE) on completion 
of the system call, as follows: 


Normal completion. 

The new file length is larger than the 
old file length. 

The name is not in the file index. 

The file is opened more than once by 
the calling program or some other problem 
program has it opened. 

New file length is zero. 

Unauthorized user trying to use the 

nn = 01 option. 

Other user number is invalid (nn = 01). 


is the (user-supplied),length of the new file. 
The system will actually reserve this length 
rounded up to the nearest 1000 (octal). 

is the binary user number of the other user 
(user-1 only). 


is taken if ss .GT. 00, and the length adjustment 
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2.11. Call 13: Adjust Program Field Length 


This call allows the problem program to change its core memory size 
in either LCM or SCM. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa . is the address of word alpha. 
Word alpha: 13nnr eturn 0000b bbbbb 
where: 13 is the code for this system call. 
nn indicates whether adjustment of large core 
memory (LCM) or small core memory 
(SCM) or both is desired as follows: 
nn=00 Adjust LCM field length. 
nn=01 Adjust SCM field length. 
nn=02 Adjust both LCM and SCM field 
lengths. 
return is the return address (see Sec. 1.2). 
bbbbbb is the address of word beta, which contains 
the (integer) size of the program. 
Word beta: LCM program size. 
(nn = 00) 
Word beta: SCM program size. 
(nn = 01) 
Word beta: LCM program size. 
(nn = 02) 
Word beta + 1: SCM program size. 
(nn = 02) 
Remarks: 


1. LCM space may be adjusted either up or down, limited by the 
size of the disk file (that is, the code length must be at least 
230 (octal) less than its disk-file size), and by maximum FLL which 
1,414,520 octal words. 

2. SCM space may be adjusted either up or down, limited by the 
large core field length (FLL). The small core field length 
(FLS) must be less than or equal to FLL. FLS must 
also be less than or equal to the available SCM space, 
currently 57,328 (decimal) = 157,760 (octal) words. 

3. If the SCM field length is expanded, the problem program is 
dumped to LCM and then the FLS is increased. 
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2.12. Call 14: Send a Message to the Controller 


This call may be used by a problem program to send a message to its 
controller. To facilitate control between a controllee and its controller, 
the act of sending a message to a controller also suspends the control lee 
and activates the controller, unless the controller is the teletypewriter. 


Format: 

Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 

Word alpha: 14nnr eturn OOmmb bbbbb 
where: 14 is the code for Send a Message to the 


Controller. 


nn determines the option to be taken: 

nn=00 Specifies the replace option described 
below; see Remark 3. 

nn=12 Specifies the replace option for messages 
sent directly to the teletypewriter. 

nn=01 Specifies the notify option described in 
Remark 3. 

nn=10 Specifies the notify option for messages 
sent directly to the teletypewriter. 

nn=03 Specifies the wait option described in 
Remark 3. 

nn=13 Specifies the wait option for messages 
sent directly to the teletypewriter. 

nn=04 Means to send a message to the high-level 


problem program controller, i.e., the problem 
program connected to the teletypewriter 
(disregarding its output bypass). 

nn=06 Same as nn=00, but transmit the message 
as binary data (no conversion). 


nn=15 Send a message to the controller who is x 
levels above this problem. x is an integer 
and is in beta(1). The message begins in 


beta(2). If a controller does not exist x 
levels above the calling PP the error return 
is given. If the teletypewriter is x levels 


above the calling PP, this option acts 
like the replace option nn = 12. 


nn=16 Same as nn=10, but transmit the message 
as binary data (no conversion). 


return is the return address (see Sec. 1.2). 
mm is the number of main-frame words in the 
message. (mm .LT. 64 for problem—-program 


messages. ) 


bbbbbb is the address of word beta, the beginning 
of the message storage area. 
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Remarks: 
1. 


There are two input message buffers for each problem program: 

o The buffer for messages from the controller, and 

o The buffer for messages from the controllee. 
Input messages are released (if they have not been accepted) when 
the problem program voluntarily suspends in an RCV state awaiting 
a message from controller or controllee. The problem program 
voluntarily suspends in a RCV state when it starts up its 
problem program controller (not teletypewriter) or controllee. 
There is only one output message buffer for the entire control] lee 
chain: The buffer for messages for the teletypewriter. 
Input and output messages may exist at the same time in the buffers. 
No message may be longer than 63 words. When a message is sent to 
the teletypewriter, it is divided into blocks of 15 words. If the 
last block is less than 15 words, a left-adjusted end~of-—message 
is added after the last message word. There may be up to 4 distinct 
messages in the output buffer at any one time as long as the 63—-word 
limit is not exceeded. Only one message may exist at any one time 
in the problem program input buffers. 
Different things happen to the message depending on whether it is 
directed to a problem program controller or to the teletypewriter. 
The terms replace, wait, and notify used above apply to messages 
directed to a teletypewriter that is logged out. 


Case 1: Message is directed to problem program controller: 
The message is always accepted by the system. 
Case 2: Message is directed to the teletypewriter: 


o Teletypewriter is logged in: 


nn = 00 The system accepts up to 4 messages (63 
06 words total) before suspending the PP to disk 
12 in an XMT state. 
03 
13 
nn = 01 The PP is sent to the error return if there 
10 is already a message in the output buffer. 
16 
o Teletypewriter is logged out (or logged in under another 
suffix): 
nn = 00 Replace: 
06 The last message sent replaces any existing 
12 message in the output buffer. 
nn = 03 Wait: 
13 The PP is suspended to disk in an XMT 
state until the teletypewriter logs in. 
nn = 01 Notify: 
10 The PP is unconditionally sent to the 
16 error return. 
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2:13. ‘Call 


15: 


Start up Controllee With or Without a Message 


This call may be used by a problem program to send a message to a 
controllee or to start a controllee without a message. Doing either of 
these things activates the controllee and suspends the controller in an 
RCV state (waiting for a message from controllee). 


Format: 


Word zero: 


where: 


Word alpha: 


where: 


aaaaa 


15 


nn 


return 


cc 


00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 


is the address of word alpha. 


15nnr eturn ccmmb bbbbb 


nn=00 
nn=01 


nn=02 


nn=03 


nn=10 


nn=15 


nn=20 
nn=21 
nn=22 
nn=23 
nn=30 
nn=40 


nn=50 


cc=00 


is the code for Send a Message to the 
Control lee. 


determines the option to be taken: 


Normal setting. 

Set this problem program’s input bypass. 
Messages from the controller bypass this 
problem program and are given to the 
controllee. 

Set this problem program’s output bypass. 
Messages from the controllee bypass this 
problem program and are given to the 
controller. 

Set this problem program’s input and output 
bypass. 

Treat the calling program like a read-only 
file: the controller (which may be the 
teletypewriter) of the calling program 
becomes the controller of the calling 
program’s controllee. Any tapes belonging 
to the calling program become the 
controllee’s tapes. 

Send a message to the controllee that is x 
levels below this problem program. x is an 
integer and is stored in beta(1)- The 
message begins in beta(2). If a controllee 
does not exist x levels below this PP, the 
error return is given. 

Start the controllee without a message. 


Like nn = 01, but without a message. 
Like nn = 02, but without a message. 
Like nn = 03, but without a message. 
Like nn = 10, but without a message. 
Like nn = 11, but also causes the controller’s 


drop file to be destroyed. 
Like nn = 30, but also causes the controller’s 
drop file to be destroyed. 


is thereturn address (see Sec. 1.2). 


is a start-up and error-return option: 


Do not start up this PP if the controllee 
suspends in an RCV state. For 
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Remarks: 
1. 


ae 


nn .LT. 20 or nn = 40, if the controllee 
already has a message from the controller, 
release it and send the controllee this 
message. 

ec=01 Start up this PP if the controllee 
suspends in an RCV state. For nn -.LT. 20 
nn = 40, if the controllee already has a 
message from the controller, release it and 
send the controllee this message. 

ec=10 Do not start up this PP if the controllee 
suspends in an RCV state. For nn .LT. 20 
nn = 40, if the controllee already has a 
message from the controller, send control 
to the error return. 


ec=11 Start up this PP if the controllee 
suspends in an RCV state. For nn .LT. 20 
nn = 40, if the controllee already has a 
message from the controller, send control to 
the error return. 


mm is the number of main-frame words in the 
message (mm .LT. 64). 


bbbbbb is the address of word beta, the beginning of 
the message storage area. 


Sending a message causes the system to copy the message from 
problem program core into a system buffer and to start the controllee. 
If the controllee is running and the controller’s input bypass is not 
set, a message from the teletypewriter causes the controllee to be 
suspended and the controller to be started. 

If the controller is running and the controller’s input bypass is 
set, and a message comes in from the teletypewriter, then for 

ce = 00 and 01 the controilee is started with the 

controller’s message and the teletypewriter message is thrown away. 
If the controller starts the controllee with no message, the 
controllee is started with the teletypewriter message. 

For cc = 01 and 11, if any controllee issues a system call to 

Get a Message or Get Symbols from Controller with the suspend 
option, and there is no message waiting for the controllee, then 
the next higher level controller problem program whose input bypass 
is not set (and which has a flag indicating it specified the 

cc = 01 or 11 option) is started and the controllee is suspended in 
an RCV state. 

There are three possible reasons for an error from this call: no 
controllee exists; mm = 00; or an illegal option was specified. 

If (1) the controller is on disk waiting for a message from 
controllee, and (2) the controllee is in a RUN, MEM, or 

XMT state, and (3) the controllee has a message from controller 
that it has not yet picked up, and (4) a message to controller 
arrives from the teletypewriter: THEN the controllee is put in an 
RCV state and the message it had not picked up is retained 

in the system buffer. The controller is put in a RUN state. 
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2.14. Call 16: Get a Message From the Controller 

This call may be used by a problem program to get a message from its 
controller. If a message is waiting. it is delivered to the requesting 
problem program. If there is no message waiting. FLOE examines the 
nn option field and performs the indicated action. 
Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 

where: aaaaaa is the address of word alpha. 


Word alpha: 16nnr eturn mm00b bbbbb 


where: 16 is the code for Get a Message from the 
Controller. 


nn indicates the suspend mode: 


nn=00 If a message is not ready and waiting at the 
instant this call is given, suspend the problem 
program from core until such time as a message 


is ready. 


nn=0 1 If a message is not ready and waiting at the 


instant this call is given, return contro] 


location "return" with the buffer unchanged. 
nn=02 If there is no message waiting when this cal] 
is issued, suspend the problem program until 


a message is ready. If there is a message 


waiting, place it in the beta buffer, but do 


not release it from the system buffer. 


nn=03 If there is no message waiting. send control 
to “return”. If there is a message waiting, 
place it in the beta buffer, but do not release 


it from the system buffer. 
nn=06 is not available. (See Sec. 2.25.) 
nn=07 is not available. (See Sec. 2.25.) 


return is the return address (see Sec. 1.2). 


mm is the maximum number of main-frame words 
to be delivered as a result of this call. 
(mm .LT. 64 for problem-program messages; 
mm is zero, a maximum of 63 words may be 
delivered.) 


bbbbbb is the address of word beta, the beginning of 


the message storage area. 


Remark: 

1. Getting a message causes the system to copy the message from the 
system buffer to the problem—program buffer. No end-of-message is 
added if the length of the message is greater than or equal to the 
number of words requested. If the message is shorter than the 
number of words requested, a left-adjusted end-of—the-message is 
added after the last message word. 
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2.15. Call 17: Get a Message From the Controllee 


This call may be used by a problem program to get a message from a 
controllee. If there is a message from controllee, it is delivered to the 
problem program. If there is no message from controllee and the problem 
program was started because its controllee suspended in a RCV state, 
then a word consisting entirely of 2’s is returned in word beta and the error 
return is taken. In all other cases where there is no message from 
controllee, minus zero is returned in beta and the error return is taken. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 17nnr eturn mm00b bbbbb 
where: 17 is the code for Get a Message from the 
Controllee. 
nn specifies the option, as follows: 
nn=00 means return the message to the PP buffer 
and release it from the system buffer. 
nn=02 means return the message to the PP buffer 
but do not release it from the system buffer. 
return is the return address (see Sec. 1.2). 
mm is the maximum number of main-frame words 
to be delivered as a result of this call 
(mm .LT. 64). If mm is zero, a maximum of 63 
words may be delivered. 
bbbbbb is the address of word beta, the beginning of 
the message storage area. 
Remarks: 


1. Getting a message causes the system to copy the message from the 
system buffer into the problem program buffer. If the length of 
the message is greater than or equal to the number of words requested, 
no end-of-message is added. If the message length is less than 
the number of words requested, a left—adjusted end—of-message 
is added after the last message word. 

2. If there is no message from controllee and the problem program was 
started because its controllee suspended in an RCV state, then 
the error return is taken and a word consisting entirely of 2’s is 
returned: beta = 22222222222222222222. In all other cases when 
there is no message from controllee, the error return is taken and 
minus zero is returned: beta = 77777777777777777777. 

3. For nn = 02, the PP may get the message again. The message is 
released by the system when the PP voluntarily suspends in an RCV 
state awaiting a message from controller or controllee. 
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2.162 Call.20: 


This cal] 


Get Symbols From the Controller 


is identical 


to Get a Message from the Controller, 


described in Sec. 2.14, except that the message is delimited 
to right-justified symbols (consisting of 10 or fewer characters) according 


to certain rules. 


Format: 


Word zero: 


where: 


Word alpha: 


where: 


aaaaaa 


20 


nn 


The symbols are placed in separate sequential computer words 


00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 


is the address of word alpha. 


20nnr eturn mmddb bbbbb 


nn=00 


nn=01 


nn=02 


nn=03 


nn=10 


nn=11 


nn=12 


is the code for Get Symbols from the 
Controller. 


indicates the suspend mode: 


If symbols are not ready and waiting at 

the instant this call is given, the problem 
program is suspended from core until such 
time as symbols are ready. 

If symbols are not ready and waiting at 


the instant this call is given, control is 
returned to location “return” with the buffer 
unchanged. 


If there are no symbols waiting when this 
call is issued, the problem program is 
suspended until the symbols are ready. If 
the symbols are ready, they are placed in the 
beta buffer, but are not released from the 
system buffer. 

If there are no symbols waiting when this 
call is issued, control is sent to “return”. 
If the symbols are ready, they are placed 

in the beta buffer, but are not released 
from the system buffer. 

The number of symbols returned is placed 

in the word whose address the user has 
specified in beta (e.g., by the statement 
BETA = .LOC.1, the number of symbols 

would be returned in 1). FLOE overwrites 
beta with the first symbol. If the symbols 
are not ready and waiting at the instant 
this call is given, the problem program is 
suspended from core until such time as the 
symbols are ready. The option nn = 10 does 
not apply to dd = 02. 

Place the number of symbols returned in the 
word whose address is specified in beta. 
Overwrite beta with the first symbol. If 
symbols are not ready and waiting at the 
instant this call is given, return control 
to location return with the buffer unchanged. 
The option nn = 11 does not apply to dd = 02. 
Same as nn = 02 and the number of symbols 
returned is placed in the word whose 

address the user has specified in beta. 
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Remarks: 


1. 


FLOE overwrites beta with the first 
symbol]. 
nn=13 Same as nn = 03 and the number of 
symbols returned is placed in the word whose 
address the user has specified in beta. 
FLOE overwrites beta with the first 


symbol . 

return is the return address (see Sec. 1.2). 

mm is the maximum number of main-frame words 
to be delivered as a result of this call 
(mm .LT. 64). If mm is zero, a maximum of 


63 words may be delivered. 


dd indicates what characters are to be used 

as symbol delimiters: 

dd=00 Symbols are delimited by spaces and control 
characters. 

dd=01 Symbols are delimited by spaces, control 
characters, comma, period, semicolon, left 
parenthesis, right parenthesis, left bracket, 
and right bracket. 

dd=02 Symbols are delimited by the characters or 
control characters specified in the beta 
buffer (one delimiter right-adjusted per beta 
word). There can be a maximum of 50 
delimiters. Any character or control 
character (i.e., any teletypewriter trio 
beginning with 40 (octal)) is allowed. A bet 
word that contains a negative integer ends 
the list. 1f no delimiters are set (that 
is, the first beta word contains a negative 
integer), then any character net a letter, 
digit, or period is a delimiter (same as 
dd = 03). 

dd=03 Symbols are delimited by any character not a 
letter, a digit, or a period. 


bbbbbb is the address of word beta, the beginning of 
the message storage area. Each incoming 
symbol is right-—justified into a separate 
word starting at word beta. 


Getting symbols causes the system to crack the message into symbols 
and copy them into the problem program core. A delimiter, other 
than a blank, is stored as a symbol. For dd = 00, O1, and 03, 
blanks are squeezed out. For dd = 02, blanks are squeezed out only 
if set as delimiters. 

For options nn = 10, 11, 12, and 13, FLOE overwrites beta with 

the first symbol. These options are not valid for dd = 02. 

If the number of symbols is greater than or equal to the number 

of words requested, no end-of-message is added. If the number of 
symbols is less than the number of words requested, a 
right-adjusted end-of-—message is added after the last symbol. 
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2.17:. Call 


This cal] 


Format: 


Word zero: 


where: 


Word alpha: 


where: 


Get Symbols From the Controllee 


is similar to Get a Message from the Controllee, described 
in Sec. 2.15, except that the message is delimited into right-justified 
symbols (consisting of 10 or fewer characters) according to certain 
rules. The symbols are placed in separate sequential computer words. 


aaaaaa 


21 


nn 


return 


mm 


dd 


00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 


is the address of word alpha. 


2innr eturn mmddb bbbbb 


nn=00 


nn=02 


nn=10 


nn=12 


dd=00 


dd=01 


dd=02 


is the code for Get Symbols from the 
controllee. 


indicates the option: 


Symbols are returned into the PP buffer 
and released from the system buffer. 

Like nn = 00, except the message is not 
released from the system buffer. 

The number of symbols returned is placed 
in the word whose address the user has 
specified in beta (e.g., by the statement 
BETA = .LOC.1, the number of symbols 
would be returned in 1). FLOE overwrites 
beta with the first symbol. The option 
mn = 10 does not apply to dd = 02. 

Like nn = 10, except the message is not 
released from the system buffer. 


is the return address (see Sec. 1.2). 


is the maximum number of main—-frame words 
to be delivered as a result of this call 
(mm .LT. 64). If mm is zero, a maximum of 
63 words may be delivered. 


indicates what characters are to be used as 
symbol delimiters: 

Symbols are delimited by spaces and control 
characters. 

Symbols are delimited by spaces, control 
characters, comma, period, semicolon, left 
parenthesis, right parenthesis, left bracket, 
and right bracket. 

Symbols are delimited by the characters or 
control characters specified in the beta buffer 
(one delimiter right-adjusted per beta word). 
There can be a maximum of 50 delimiters. 

Any character or control character is 

allowed. A beta word that contains a negative 
integer ends the list. If no delimiters are 
set (that is, the first beta word contains 

a negative integer), then any character not 

a letter, digit, or period is a delimiter 
(this is the same as dd = 03). 
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Remarks: 
1. 


dd=03 Symbols are delimited by any character not 
a letter, a digit. or a period. 


bbbbbb is the address of word beta, the beginning of 
the message storage area. Each incoming 
symbol is right-justified into a separate 
word starting at word beta. 


Getting symbols causes the system to crack the message into 

symbols and copy them into the problem program core. A delimiter, 
other than a blank, is stored as a symbol. For dd = 00, 01, and 03, 
blanks are squeezed out. For dd = 02, blanks are squeezed out only 
if set as delimiters. 

Options nn = 10 and 12 do not apply to option dd = 02. 

If there are no symbols from the controllee and the problem program 
was started because its controllee suspended in an RCV state, 

then the error return is taken and a word consisting entirely of 
2°s is returned: beta = 22222222222222222222. In all other cases 
when there is no message from controllee, the error return is te':en 
and minus zero is returned: beta = 77777777777777777777. 

lf the number of symbols is greater than or equal to the number of 


words requested, no end-of-message is added. If the number of 
symbols is less than the number of words requested, a right-adjusted 
end-of-message is added after th. last symbol. 
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2.18. Call 22: Initialize or Disconnect a Controllee 


This call is used by a problem program to initialize another problem 
program as its controllee, or as a stand-alone problem program under a 
different suffix. This call may also be used by a problem program to 
disconnect a previously initialized controllee. Cal! 22 also allows for 
executing a controllee from a library file. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 22nnr eturn mpssb bbbbb 
where: 22 is the code for this system call. 
nn indicates the option: 
nn=00 Initialize a controllee. 
nn=01 Disconnect a controllee (no beta words 
needed). 
nn=02 Initialize a controllee at a priority other 


than the controller’s. (A nonzero time limit 
must be specified.) 


nn=10 Initialize a controllee and start 
immediately. 
nn=12 To initialize a controllee at a priority 


other than the controller’s and start 
immediately. 

nn=20 Initialize a controllee and start controllee 
immediately. Start up this problem if the 
controllee suspends in an RCV state. 

nn=22 Initialize a controliee at a priority other 
than the controliler’s and start controllee 
immediately. Start up this problem program 
if the controllee suspends in an RCV state. 
(A nonzero time limit must be specified.) 

nn=30 Initialize and start a controllee under 
another suffix. 

nn=32 Like nn = 30 but at a priority other than 
that of controller. (A nonzero time limit 
must be specified.) 


return is the return address (see Sec. 1.2). 


m if nonzero, sets the time-limit-notify option 
(see Remark 10). 


p is a three-bit, field expandable as follows: 
--1 Set controller input bypass. 
-1- Set controller output bypass. 
1-- Take the error return if the system tables 


are full. (No descriptor block available.) 


ss contains an error code if the error return is 
taken. The error codes are: 
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bbbbbb 


Word beta: 
(all options) 


Word beta + 1: 
(all options) 


where: f 


XXXXXXX 


tt 


Word beta + 2: 
(nn = 02,12,22,32) 


Word beta + 2: 


(nn = 00,10,20) 


Word beta + 3: 
(nn = 02,12,22) 


Word beta + 2: 
(nn = 30) 


where: ss 


kk 


ss=00 
ss=01 
ss=02 


ss=03 
ss=04 
ss=05 
ss=06 
ss=07 
ss=10 
ss=11 
ss=12 
ss=13 
ss=14 
ss=15 


ss=16 
ss=17 


Normal return. 

Program already has a controllee. 

Too many controllees in chain (maximum of 
9 allowed). 

No name given. 

No file of given name. 

Access denied. 

File is type data. 

FLL size no good. 

Illegal f option (see word beta + 1, below). 
FLL larger than file size. 

Given priority is not floating-point. 
System tables are full. 

No time left for user account. 
Insufficient time in repository for time 
limit. 

Illegal suffix 

Specified suffix is in use. 


is the address of a word, beta, containing 
the name of the problem to be started. 


Controllee (or library) file name (ASCII, 
right-justified). (See Remarks 5. 6, 7, and 8.) 


fxxxx xxxtt ttttt ttttt 


is a field-length option field (see Remarks 
5, 6, 7, and 8) or is a library load option 
(see Remark 14). 


is the size at which to start the controllee 
(or length of load from iibrary). 


is the time limit for the controllee, in 
microseconds. If tt = 0, the controllee 
shares the controller’s current time limit. 


The floating-point priority to be used for the 


controllee. If beta + 2 is zero, the controller’s 
priority is used. If beta +2 isa 
right-justified ASCII S, standby 

priority is used. 


Certain information (dependent on the value of f) 
pertaining to the size of the controllee (see 
Remarks 5, 6, 7, and 8). 


Certain information (dependent on the value of f) 
pertaining to the size of the controllee (see Remarks 
5,6, 7, and 8). 


sskkO 00000 00001 11111! 


is the other suffix (integers 01 to 05 for 
suffixes A to E). 


is the word count of the message to be sent. 
If kk = 0, no message is assumed. 


}}itd) is the FLS (see Remarks 5 and 6). 


For nn = 30 the message text is assumed to follow word beta + 2 immediately. 


Word beta + 3: sskkO 00000 0000] IJ111! 
(nn = 32) 
where: ss, kk, and J1]1111 are the same as in 
beta + 2. 


For nn = 32 the message text is assumed to follow word beta + 3 immediately. 


Remarks 
1. Options nn = 00, 02, 10, 12, 20, and 22 are in error if a controllee i 


already present. Option nn = 01 is in error if no such controller 
is present. 

2. Setting the time limit in beta + 1 does not affect the priority of 
the controllee. 

3. For options nn = 02, 12, 22, or 32 the error return is taken if 


beta + 2 is not floating-point, is negative, or has an exponent 
field of 1777 or 3777. 

4. If nn = 00 or nn = 02, the controller must send a message to the 
controllee to start it. If nn = 10, 12, 20, or 22, the controller 


is dumped to disk and the controllee is started without a message. 

5. The field-length option provides a means of specifying the 
controllee’s large core field length (FLL) and small core field 
length (FLS). 

a. If f = 0 and xxxxxxx = 0, the large core size is taken as 
the disk-file size. Large core field length is disk size 
minus 230 (octal). Small core size and field length are 
taken from information in the exchange package in the disk 
file. If the load size has been previously specified as 
being different from the disk-file size, the specified load 
size preempts the disk-file for large core field tength. 

b. If f = 0 and xxxxxxx .NE. 0, large core field length is taken 
from the x field in beta + 1. Large core size is x plus 
230 (octal). Small core size and field length are 
taken from information in the exchange package in the disk file. 

ce. If f = 1, large core size is taken as the disk-file size. 
Large core field length is disk size minus 230 (octal). 
Small core field length is taken from the x field in 
beta + 1. 

d. If f = 2, large core field length and small core field 
length are taken from the x field in beta + 1 and are equal. 
Large core size is x plus 230 (octal). 

6. Note that if a priority for the controllee is specified in word 
beta + 2, the supplementary data required by certain f options is 
moved to word beta + 3. Word beta + 2 for nn = 00, 10, or 20, or 
word beta + 3 for nn = 02, 12, or 22, have the same format, as 
described here. 

a. If f = 3, large core field length is taken from the x field 
in beta + 1. Large core size is x plus 230 (octal). Small 
core field length is taken from the low-order 18 bits of 
beta + 2, or beta + 3. 

b. If f = 4, beta + 2 or beta + 3 has the format 


00000 O00cce ececeOd 00000. 
The cececece field specifies the disk address from which the 


system will begin loading the controllee. The large core field 
length and small core field length wil] be taken from the 
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10. 


11. 


le. 


13. 


14. 


exchange package. (See Remark 14.) The initial load length 
from disk to large core will be the entire file length. 
For f = 0, 2, or 3, the large core field length, specified in x, 
must be less than or equal to the disk-file size minus 230 (octal). 
For f{ = 4 and nn = 30 or 32, beta + 2 or beta + 3 has the format 


sskkO OOccc cceccO 00000. 


The ccecee field specifies the disk address from which the system 
will begin loading the controllee. The large core field length 

and smal! core field length will be taken from the exchange 

package. (See Remark 14.) 

For nn = 20 and 22, if the controllee issues a Get a Message 

or a Get Symbols from Controller system call (Call 16 or 20) 

and there is no message waiting, then the next higher level 
controller problem program whose input bypass is not set (and which 
also has a flag indicating it specified the nn = 20 or 22 option) 

is started and the controllee is suspended in an RCV state. 

If field m is nonzero, the controller problem program is notified 
when the controllee’s time limit has been exhausted. The 

controllee is not terminated and remains connected to the controller 
in an RCV state. The notification message sent to the controller 
program has the octal format: 

word 1: 40777 76454 00457 05041 

word 2: 65636 44544 00465 76200 

word 3: controllee name 

word 4: 40777 74002 04000 00000 

Options nn = 30 or 32 allow the usual field length, priority, 

and time specifications plus the ability to send the initialized 
controllee one startup message. Under the specified suffix the 
newly initialized controllee is connected directly to the teletype— 
writer. It is started immediately upon completion of initialization. 
Once the initial message, if any, has been sent to the new 
controllee, no further communication with it through the operating 
system is possible. The initiating program may have local 
controllers and/or controllees when making the new call and may 
initiate a local controllee after having initialized and started a 
controllee under another suffix. Note: the p field (bypass option) 
is ignored for options nn = 30 and 32. 

When using nn = 30 or nn = 32, the user must specify a nonzero 

time limit for the job being initialized under the specified suffix. 
For options nn = 30, nn = 32, if there is a program active under the 
other suffix, the error return is taken and ss = 17. If there 

had been a job under the other suffix and it is currently in a 
termination state, the last message it may have sent to its control 
terminal and its ALL DONE message are released and initializatio 

is allowed. 

For options nn = 2, nn = 12, nn = 22, nn = 32, if the new priority 
is to be Standby, the beta word should contain a right-justified 
ASCII S. 

When f = 4, a problem-program controller can initialize any one of 
many controllees in a program library file. The controller wil] 
have to specify the initial address and the length of the controllee 
within the disk file named as the library file. All the usual 
priority and time-limit options will be allowed to coexist with the 
new option. 


The controller will specify the name of the file to be referenced, 
the address of word zero of the program minus words, and 

a length to be loaded. The operating system will use the exchange 
package in the minus words for FLL and FLS. FLL must be less 
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equal to the load length minus 230 (octal). Other f-field options 
will be disallowed. 


Upon the initial load, the controllee will have the name of the 
library file and all its attributes except size and write access. It 
is expected that the user will use the system drop~file-create cal] 
and specify a name in that call. If it becomes necessary to drop 

the controllee to disk and no drop file has been created, the 
controllee will be terminated in memory with no current image 
preserved on disk. Modifying the FLL will not be allowed before 

the controllee has made a drop-file call or a program-name-change 
call. 
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2.19. Call 23: Close 


This call makes 


it possible for the requesting problem program to 


sever its connection with a disk file or set of disk files without 
affecting the status of the files in question (compare Destroy, Sec. 2.2). 


Format: 


Word zero: 


where: aaaaaa 
Word alpha: 
where: 23 
nn 
return 
bbbbbb 
Word beta: 


where: mm 


rr 


ss 


tt 


00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 


is the address of word alpha. 


23nnr eturn O000b bbbbb 


is the code for Close. 
is the number of files requested (nn .LT. 17) 
is the return address (see Sec. 1.2). 


is the address of the first word, beta, of the 
nn requests. 


mmrrs sOltt OOOff fffff 


rr=00 
rr=01 
rr=02 
rr=03 
rr=04 


is the 10C word of the file to be closed. 
indicates the read-write status: 


No change. 

Make this file a read-only file, starting now. 
Make this file a read-write. file, starting now 
Make this file a data file, starting now. 

Make this file an execute-only file, starting 

now. 


is filled in (by FLOE) on completion of 
the system call, as follows: 


Normal completion. 
ff is greater than the disk size minus 230 
(octal), or is zero. 


The file being closed is no longer in the 
file index, or no name was given. 

An improper IOC word was used; no close 
is performed. 

Access was denied. 

Nondisk IOC, no close is performed. 


is a three-bit field expandable as follows: 


Install load size (FLL—-see the fffffff 
option below) at which the program is to be 
loaded the first time (19 bits maximum). 
Remove the load size (FLL). 

Clear the file-modified bit. 


indicates pool file status This option is 
restricted to authorized pool bosses only. 
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Remarks: 
1. 


2. 
3. 


tt=00 No change. 
tt=01 Make this a pool file starting now. 
tt=02 Take away the pool file status starting now. 


fffffff is the size (FLL) at which the program 
is to be loaded the first time (19 bits 
max imum). 


All beta words have the same format as beta. There are nn beta 
words in all. 

If rr = 02 and the file is public, access is denied. 

For ss = 02, 03. 04, or 05, the rr and 1 options are not exercised. 
For ss = 01 the | option is not exercised. 

Upon completion, zeroes are placed in the corresponding IOC 
words, meaning that this file has been removed from the problem 
program’s list of input/output files. 

This call processes all beta words. If at least one has an ss 
field equal to 01, 03, 04, or 05, control is sent to return. 

lf the 10C being closed is a tape IOC: 

a) The IOC words will be cleared. 

b) The ss field will be set to 02. 

c) The normal return will be taken. 

d) The tape will remain assigned in the system’s device tables. 
e) The tape is not rewound and/.r unloaded. 

If the program should create another tape or disk file using the 
same IOC as the one just closed, the create will be successful. 
That IOC may later be closed again and the original tape re— 
created with positioning intact. This method of sharing I10C’s 
should only be used in desperate situations since it causes tape 
drives to be tied up when not actually in use. 
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2.20. Call 24: General Purpose 
This call allows the requesting problem program to: 


Modify its time limit 

Get its user identification number and bank account 
Change its priority 

Get its current time limit and priority 

Get its name 

Get its controllee’s name 

Get its controller’s name 

Change the time limit and priority of its controllees 
Get its current charges 

Get its minus words. 

Cause its current LCM image to be copies to its 
disk drop file. 


ooo0oo0oo0oo0o0o000 0 


Format: 


Word zero: 00000 00000 1004a aaaaa or 
00000 00000 1005a aaaaa 


where: aaaaaa is the address or word alpha. 
Word alpha: 24nnr eturn uuvvb bbbbb 
where: 24 is the code for this system call. 
nn indicates which option is desired: 
nn=00 Modify time limit. 
nn=01 Get user identification number 
and current bank account. 


nn=02 Change priority. 
nn=03 Get time limit and priority. 


nn=04 Get program’s time used. 

nn=05 Get the problem program name 
and field length. 

nn=07 Get the problem program name, 


user number, terminal, and suffix. 
nn=10 Get CPU time and 1/0 time 
(real, unweighted). 


nn=11 Get total real CPU time, real 
system-cal! CPU time, and real 
1/O time. 

nn=12 Get user charged time. 

nn=13 Get descriptor—block dead-start 
flag. 

nn=14 Recharge user-1 for user service. 

nn=15 Get controllee name and field 
length. 

nn=16 Erase user-I tape ID. 


nn=22 Change priority and time limit of 
controllees. 


nn=25 Get controller name and field 
length. 

nn=30 Set file-transport—complete flag 
in file index. 

nn=31 List active suffixes. 

nn=33 Get suffix and account number. 
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Word beta: 


(nn = 00) 


Word beta 
(nn = 00) 


Word beta: 


(nn = 01) 


Word beta 
(nn = 01) 


Word beta: 


(nn = 02) 


Word beta 
(nn = 02) 


Word beta: 


(nn = 03) 


Word beta 
(nn = 03) 


Word beta: 


(nn = 04) 


Word beta 
(nn = 04) 


Word beta: 


(nn = 05) 


+ 


uu 


VV 


return 


bbbbbb 


nn=34 Get all or part of this problem 
program’s minus words. 

List the problem program names of 
the controllees in this chain 
starting with the controllee 


connected to the teletypewriter. 


nn=386 


contains the number of words in beta 


(supplied by the user). 


is the position of the calling program 
in the chain (returned by FLOE). 


is the return address (see Sec. 1.2). 


is the address of a word, beta, 
whose format is described below. 


The new limit (integer microseconds), from the 
problem program. 


The value of the time limit (integer micro— 
seconds) at the time this call was made. and 
prior to installing the new time limit, 
filled in by FLOL. 


The user identification number (ASCI1, 
right-justified), filled in by FLOE. 


The current remaining repository time (integer 
microseconds), filled in by FLOE. 


The new priority (floating-point), from the 
problem program. If beta = 0, the calling 
program is immediately dumped to disk; its 
priority is not changed. To change to 
Standby priority: beta = S (the ASCII 
character S). 


The existing priority (floating-point) at the 
time this call was made, filled in by FLOE. 


The existing time limit (integer microseconds), 
filled in by FLOE. 


The existing priority (floating-point), 
filled in by FLOE. 


The total priority—-unweighted charged time 
incurred under a suffix by the current job chain. 


The priority-unweighted charged time incurred 
by the calling program only. If this program 
is the highest in the chain (i.e., the 
controller connected to the teletypewriter), 
the charged time represents the total of it and 
all controllees under the suffix. 


The name under which this program is running 


(ASCII, right-justified), filled in by 
FLOE. 
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Word beta + 1: 


(nn = 05) 
Word beta: 
(nn = 07) 
where: 
Word beta + 
(nn = 07) 
Word beta: 
(nn = 10) 
Word beta + 
(nn = 10) 
Word beta: 
(nn = 11) 
Word beta + 
(nn = 11) 
Word beta + 
(nn = 11) 
Word beta: 
(nn = 12) 
Word beta: 
(nn = 13) 
Word beta: 
(nn = 14) 
where: 


Word beta + 1: 


(nn = 14) 


where: 


XX 


tt 


aa 


aa 


bb 


uu 


ii 


cc 


The large-core field length of this program, 
filled in by FLOE. 


xxttt tttaa aaaaa aaaaa 
is the suffix (ASCII, left- 
justified). 

t is the Octopus terminal number 
in compressed 8—-bit format 


(returned if the user is logged in). 


a is the user number (ASCII, right- 
justified). 


The program name (ASCII, right- 
justified), filled in by FLOE. 


Real, unweighted CPU time used (integer 
microseconds). 


Real, unweighted I/O time used (integer 
microseconds). 


Total rea] CPU time used by this program 
(microseconds). 


Total real system-cal!] CPU time incurred 
by this program (microseconds). 


Total real I/O time used by this program, 
including load/dump 1/0 charge (microseconds). 


The user’s current total priority-—weighted 
charged time. 


The descriptor—block dead-start flag, 
filled in by FLOE. 


000aa aabbb bbbuu uuuuu 
a is the binary effort number (blank 
for file transport). 


b is the ASCII account designator 
(blank for file transport). 


u is the binary user number. 


11111 11111 ceece ccece 


i is the I/O charge (blank if file 
transport). 


c is the CPU charge (blank if file 
transport). 
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Word beta: 
(nn = 15) 


Word beta 
(nn = 15) 


Word beta 
(nn = 16) 


Word beta: 
(nn = 22) 


Word beta 
(nn = 22) 


Word beta: 
(nn = 25) 


Word beta 
(nn = 25) 


Word beta: 
(nn = 30) 


Word beta 
(nn = 30) 


Word beta: 
(nn = 31) 


where: 


Word beta: 
(nn = 33) 


where: 


aa 


bb 


ec 


dd 


ee 


xx 


The controllee name (ASCII, right- 
justified), filled in by FLOE. (If 
no controllee, error return is taken.) 


The controllee large-core field length, 
filled in by FLOE. 


The ASCII tape name. 


The new priority (floating-point) at which 
the problem program and its controllees are 
to run, from the problem program. If beta = 
O no change is effected. To change to 
Standby priority: beta = S (the ASCII 
character S). 


The new time limit (integer microseconds) at 
which controllees are to be run, from the 
problem program. 


The controller name (ASCII, right- 
justified), filled in by FLOE. (If 
no controller, error return is taken.) 


The controller large-core field length, 
filled in by FLOE. 


A disk-file name (ASCI!, right- 
justified). 


A user identification number (binary). 


00aa0 ObbOO cc00d d00ee 


is the ASCII character A 
if suffix A is active, or is zero. 


is the ASCII character B if 
suffix B is active, or is zero. 


is the ASCII character C if 
suffix C is active, or is zero. 


is the ASCII character D if 
suffix D is active, or is zero. 


is the ASCII character E if 
suffix E is active, or is zero. 


xxecs sdbaa aaaaa aaaaa 


contains the ASCII code for the 
suffix under which the calling 
program is executing (if the tele- 
typewriter is logged in with the 
same suffix), or zero. 
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d=1 if job is being run in “batch” mode. 
Implemented for “batch” ORDER only. 


b=1 if job is being run at first-tier 
(normal) standby priority. 

b=2 if job is being run at second-tier 
(free) standby priority. 

b=0 for all other cases. 


aaaaaaaaaaaa contains the ASCII code for the 
account number to which this job is 
being charged. 


ss is the ASCII suffix under which 
the job is running. 


ec is the access code (octal integer). 


Word beta: 00000 00sss 00000 00111 (stored by the program) 


(nn = 34) 


where: sss is starting address. 


1}1 is length. 


Word beta + 1: The minus words are stored by FLOE 


(nn = 34) 


Remarks: 
1. 


beginning here. 


Option nn = 02 causes the problem program to be dumped 

to disk and queued for reload at the new priority. If 
beta = 0 no priority change occurs; this artifice can he 
used to force an update of a program on its disk drop file. 
The error return is taken for nn > 03 if the new 

priority is not a positive floating-point number, or if 
the new priority has an exponent field of 1777 or 3777, 
unless the new priority is Standby. 

For nn = 13 the descriptor—block dead-start flag is reset 
to 0 upon completion of the call. The dead-start flag 

is set to 1 in each descriptor block describing a program 
that is to be resurrected after the dead start. This 
provides a means to determine if a dead start occurred 
during the execution of a program. 

The nn = 30 call is used by the FLOE system file-transport 
routine to turn on the file-complete bit (see Sec. 2.7) 
in the file index for the file named in word beta. 

For nn = 34, the beta buffer must be entirely in SCM. 
Also, sss + 11] must be less than equal to 230 (octal). 
For nn = 36, if the number of controllees in the chain is 
less than uu, the remaining beta words are cleared. 

For nn = 31, the suffix will be indicated zero if it is 
sufficiently inactive to permit the initialization of a 
controllee under that suffix. (See Sec. 2.18, 

nn =30, 32.) 
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2.21. Call 25: Suspend and Automatically Restart 


This call suspends the problem program issuing the call 
and automatically restarts it at a later time. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 
00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 25nnr eturn 0000b bbbbb 
where: 25 is the code for Suspend and 
Automatically Restart. 
nn specifies the option: 
nn=00 Recall! this program after a 
certain period of time. 
nn=01 Recall some other program 
immediately. 
nn=02 Recall @ program under a 
specified suffix. 
return is the return address (see Sec. 1.2). 
bbbbbb is the addres of a word, beta, 
whose format is described below. 
Word beta: Suspend time (integer microseconds). 
(nn = 00) 
Word beta: Program name (ASCI1, right-justified). 
(nn = 01) 
Word beta: Suffix to be recalled. Integers 1 to 5 
(nn = 02) correspond to suffixes A to E. 
Remarks: 
1. The suspend length must be between 15 seconds and 30 
minutes. 
2. The error return is taken if the problem program owns a 
tape. A controllee sharing tape access with a 


controller PP may not suspend. 

3. At the time this call is issued, the job is suspended 
from all operation for the period specified, and is ina 
SUS state (state = 31). At the end of the suspension 
period, the job is pul into a state = 11 and is eligible 
to run again. Control is then sent to normal return 
(see Sec. 1.2). 

4. For nn = 01 all other active suffixes are searched for 
the program name given in beta. If this name is found, 
and if the program is in state = 31, that program is 
put into a MEM state and hence is eligible to execute. 

5. For nn = 02, the specified suffix is examined for a 
suspended program. If there is one it is placed in an 
active state. If there is no program, or if the 
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specified suffix is out of range, the error return is 
taken. 

A message from controller or from controllee will! awaken 
the problem program. When a problem program is dumped to 
disk in an SUS state, its messages (if any) are NOT 
released from the system buffer. 
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2.22. Cali 26: Control Message Bypasses 


This call allows a problem program to turn input and/or 
output bypasses on or off. If a problem program’s output 
bypass is turned off, it receives messages generated by its 
controllee. If its output bypass is turned on, messages 
sent by its controllee bypass the problem program and go to the next 
higher controller problem program whose output bypass is turned off. 
If a problem program’s input bypass is turned off, it receives 
messages generated by its controller. If its input bypass is 
turned on, messages sent by its controller bypass the problem 
program and go to the next controllee whose input bypass is turned 
off. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 
00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 26nnr eturn jjmm0 00000 
where: 26 is the cude for this sytem call. 
nn determines the type of bypass: 
nn=01 Input bypass. 
nn=02 Output bypass. 
nn=03 Both input and output bypasses. 
return is the return address (see Sec. 1.2). 
jj determines the nature of the request: 
jj=0o Turn off bypass. 
jj=01 Turn on bypass. 
mm stands for problem program, 
controller, or controllee: 
mm=0 1 Problem program. 
mm=02 Controllee. 
mm=03 Controller. 
Remarks: 
1. If mm = 02 and there is no controllee, or if mm = 03 and 


there is no controller, control is sent to “return”. 

2. For nn = 01 or 03, and mm = 01 or 02, if the problem 
program whose input bypass is being set does not have a 
controllee, then control is sent to "return". 

3. The controller’s input and output bypasses are turned 
off when its controllee terminates or is disconnected. 
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2.23. Call 27: Get a Clock Reading 


This call allows a problem program to get the value of the 
7600 microsecond clock or the LLL master clock. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 
00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 27nnr eturn OOmmb bbbbb 
where: 27 is the code for this system call. 
nn determines which clock: 
nn=00 Microsecond clock. 
nn=01 LLL master clock. 
return is the return address (see Sec. 1.2). 
mm indicate. the format for the LLL 
master clock. 
mm=00 means return the LLL master 
clock in beta in the format given 
in Remark 1. 
mm=0 1 means return the LLL master 
clock in beta in the format given 
in Remark 2. 
bbbbbb is the address of a word, beta. in 
which clock time is placed. 
Remarks: 


1. The format of the LLL master clock (in bits) is 


where: c= 1 means the clock is changing. 
nnnnn is months. 
dddddd is days. 
hhhhhh is hours. 
mmmmmmm is minutes. 
SSSSSSS is seconds. 
1111 is milliseconds. 
kkkkkkkk is year. 
jjj is day of week. 
=c means power failure. 
iiiiiii is ASCII machine identification 


(R, S, T, or U). 


Except for the machine designation and the c and p bits, 
these bits contain a modified form of BCD. Each group 
of 4 bits, counting from right to left, can contain the 
values 0000 (zero) to 1001 (nine). 
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The ASCII (left-adjusted) format of the LLL master 
clock occupies beta and beta + 1, as follows: 


beta = hh.mm.ss00 


where: hh is hours. 
mm is minutes. 
ss is seconds. 


beta + 1 = xmm/dd/yy0 


where: x is the 
mm is the 
dd is the 
yy is the 


machine designation. 
month. 

day. 

year. 
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2.24. Call 30: Modify System User Directory (Restricted Use) 


This call allows the modification of the bank account of an 
existing user number, the addition to the user directory of a new 
user number, the deletion of a user number from the user directory, 
the update of effort-account tables, or the donation of time from 


pool to pool. Its use is restricted. 
Format: 
Word zero: 00000 00000 1004a aaaaa or 
00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 30nnr eturn mmmmb bbbbb 
where: 30 is the code for Modify System 
User Directory. 
nn is the option field: 
nn=00 Modify the existing mm bank accounts, 


or add ii they are not already in the 
user directory. 


nn=01 Add the mm new accounts. 
nn=02 Delete the mm existing accounts. 
nn=03 Donate from one pool to another. 


nn=04 Update OPARAM (the system 
operating parameter table). 


nn=05 Access contro] update. 

nn=06 Access control update. 

nn=10 Instal] effort account tables. 
return is the return address (see Sec. 1.2). 
mmmm is the number of accounts tv be 


processed by this call. 


bbbbbb is the address of a word, beta, whose 
format is described below. 


Word beta: (binary) assss sfitr yllle ceece cpddd ddddd 
ddddd ddddd uuuuu uuuuu uuuuu uuuuUu 


where: a is the second-tier standby 
authorization bit. 


SSSSS is the error code, filled in by 
FLOE on completion of the 
system call as follows: 


sssss=00 Normal completion. 


sssss=01 Program is trying to add a user 
number which is already there. 

sssss=02 There is a group code mismatch 
on an update. 

sssss=03 There is no such user number to 
update, or the user directory is 
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full when trying to add a new 
full when trying to add a new number. 

sssss=04 User directory is full when trying 
to add a new number, or repository 
is full when trying to add a new 
account. 

sssss=05 The percentage eccccce is 
greater than 100. 

sssss=06 Not enough time in donor 
repository (nn = 03). 

sssss=07 Illegal nn option. 

sssss=10 Group code mismatch when updating, 
but update was done anvrway. 


f is the charged-time reset switch. 


f (if nn=02) is the user-—directory erase 
control (i.e., f .NE. 0 causes 
total erasure of the user 
directory entry; if f = 0, the 
inhibit bit is set). 


i is the console access switch. 


t is the production~number switch. 
r is the operation number switch. 
y is the must—use-combination switch. 


111 is the maximum protection level. 


ecceecce is the maximum percentage of the 
repository this user may charge. 


Pp is the repository sentinel: 
p=0 User number. 
p=1 Repository. 


dddddddddddddddddd is the ASCII group code. 


uuuuuuUuUUUUUUUUUUUU is the binary user number. 


Word beta + 1: if p=0: is a 60-bit list of file-pool 
(nn = 00,01) access keys. 
if p=l: XVVVV vVvZZzZ Z2ZZZZ ZZZ2Z 
x is a three-bit field, the last 


bit of which is not used: ab-. 
Bit a is the over-subscription 
prevent option. If set, the 
repository is examined for 
available time as each job is 
initialized. Bit b, if set, 
indicates that bit a only is to 
be stored in the particular 
repository. All other fields 
are ignored. 
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VVVVVV is the divisional overhead 
account code (alphabetic portion 
only) given in ASCII (three 
characters maximum). 


ZZZZZZZZZZZZZ is the bank account quantity, in 
microseconds to be stored into 
the repository. 


Remarks: 

1. If ss = 00 contro! goes to return + 1; if ss .NE. 00 
contro! resumes at “return”. 

2. This is a restricted call; it is accepted only from certain 
programs known to the FLOE system. Any program not 
having the required qualifications is given the error return. 

3. Word beta + 1 is not used for nn = O02. 

4. For nn = 00, the first 15 beta words should be formatted as 


follows: 

beta: Time of bank update. 

beta+i: Bank name. 

beta+2: Minimum priority (floating point). 
beta+3: ddddd ccccc oo000 wwwww 


where: ddddd is the do-not-disturb factor. 
eccee is the channel charge factor. 
oooeo is the read-only file lifetime 
(microseconds/2**24) 
wwwww is the read-write file lifetime 
(microseconds/2**24) 


beta+4: Maximum priority (floating point). 

beta+5: Standby priority (floating point). 

beta+6: LCM residence charge factor (floating point). 
betat+7: CPU use charge factor (floating point). 
beta+8: mnnnn nnnnn ppppp ppppp 


where: nn. ..n is anull field. 
pp .- .p is the maximum PP LCM size 
(i.e., FLL+230 (octal)). 


beta+9: through beta+15 are reserved for future use. The 
actual bank-account data begins in betati16. 


5. For nn = 03 word beta has binary donor repository number. 
Word beta + 1 has binary donee repository number. Word 
beta + 2 has microsecond donation. 

6. For nn = 10 word beta has LETRY for effort table or 
NUMRY for account table. Word beta + 1 has length 
of table following beta + 1. Words beta + 2 and following 
have effort or account tables. 
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2.25. Call 31: Send a Message to Device 


This call may be used by a problem program to send a message to a 
non-teletypewriter device: TMDS, RJET, file transport, etc. 


Format: 
Word zero: ; 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 


where: aaaaaa is the address of word alpha. 


Word alpha: 3innr eturn 0000b bbbbb 
where: 31 is the code for this system call. 


nn is the suspend option: 


nn=00 If the message cannot be sent at this 
instant, send control to “return”. 

nn=01 lf the message cannot be sent at this 
instant, suspend the PP in a state = 
44(octal) (TMDS and Elephant) or 
state = 22(octal) (RJET) until the 
message can be sent. 


return is the return address (see Sec. 1). 


bbbbbb is the address of a word, beta, whose 
format is described below. 


Word beta: Obssd ddddd mmmmx xxxxx 
where: b is a flag for bits—per-byte: 


mmmm is in main-frame words. 
mmmm is in 8-bit bytes. 


logos 
wot 


== © 


ss is filled in by FLOE or completion of 
the call, as follows: 


ss=00 Normal completion. 

ss=01 The message cannot be sent at this time 
and nn=00. 

ss=02 User is denied access to this device. 

ss=03 Word-count error. 


dddddd is the machine-device identification number 
(see Remark 1). 


mmmm is the number of main~frame words (b=0) or 
8-bit bytes (b=1) in the message. For b=0, 
mmmm .LE. 14 for all except RJET,. 
mmmm .LE. 512 for RJET. For b=1, 
mmmm .LE. 105 for all except RJET. 


XXXXXX is the address of the beginning of the 
message. 


Word beta + 1: The low-order 16 bits contain message-header type 
control information in the format: flebttttceccececck. 
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where: f (first bit) 


Remarks: 


1. 


sequence of messages. 


1] (last bit) identifies this message as the last in 


e (error bit) is not used on output, and is zeroed by the 
system. 
b (binary bit) is a convert flag. if b=0 FLOE treats the 


sequence of messages. 


message as a character string and converts 


from 6-bit to 68-bit ASCII. If b=1 


FLOE treats the message as a binary string 


and does not change it. 


tttt (type field) contains type information. 


eeccece 


(control field) contains control information. 


k (chain bit) is set by the system. 


The dddddd field, the machine-device identification number, 
contains 18 bits in the format: 


OOmmmmmmmmdddddddd 


where mmmmmmmm is the machine, and dddddddd is the device. Valid 


machine-device fields are (all these numbers are octal): 


mmmmmmmm=20 


identifies this message as the first ina 


a 


PDP-10 concentrator for TMDS and file transport. 
For this value of mmmmmmmm, the dddddddd may be: 


dddddddd=1 File transport. 

dddddddd=3 TMDS . 

dddddddd=7 TMDS status display (system only). 
TMDS-II master computer. 


TMDS-I1 computer one. (Channels O through 177 
(octal).) 


TMDS-I1 computer two. (Channels 200 through 
377(octal).) For these three values of 
mmmmmmmmn, the dddddddd should always be 0. 
PDP-11 concentrator for RJET. (User-1, only.) 
PDP-11 collector for RJET. (User-1, only.) 
PDP-8 terminal for RJET. (User-1, only.) 
PDP-8 terminal for RJET. (User-1, only.) 
PDP-8 terminal] for RJET, (User-1, only.) 


For these five values of mmmmmmmm, the dddddddd 
may be: 


it 


dddddddd=0 Computer. 
dddddddd=! Printer. 
dddddddd=2 Card reader. 
dddddddd=3 Teletypewriter. 
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2.26. Coll 32: 


Get a Message from Device 


This call may be used by a problem program to get a message from a 


non-teletypewriter device: 


Word zero: 
where: 
Word alpha: 


where: 


Word beta: 


where: 


Word beta + 1; 


where: 


aaaaaa 


32 


nn 


return 


bbbbbb 


ss 


dddddd 


XXXXXX 


ww 


TMDS, RJET, file transport, etc. 


00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 


is the address of word alpha. 


32nnr eturn O000b bbbb 


nn=00 


nn=0 1 


0Ossd 


ss=00 


ss=01 


ss=02 


ss=03 


is the code for this system call]. 
is the suspend option. 


If there is no message waiting at this 
instant, send control to return. 

If there is no message waiting at this 
instant, suspend the PP in a PDP 

state (32(octal)) until a message arrives. 


is the return address (see Sec. 1). 


is the address of a word, beta, whose format 
is described below. 


ddddd mmmmx xxxxx 


is filled in by FLOE on completion of the 
call, as follows: 


Normal completion. 

There is no message waiting from the 
teletypewriter or non-teletypewriter device 
and nn=00. 

Time-out error. No message was returned 
from the PDP-10 within the suspension time. 
Good return: a message has been received from 
the PP’s controller. <A message from non- 
teletypewriter device may or may not have 
been returned. A nonzero dddddd means a 
message from device was delivered to the PP. 


is the machine-device identification number 
(filled in by FLOE); see Remark 1. 


is the maximum number of main-frame words 
to be delivered as a result of this call. 


is the address of the beginning of the 
message—buffer area. 


wwwww wwwww O0000vV vvvvv 


» WwW 


is the suspend time in microseconds. If no 
message is received from the PDP-10 within the 
suspension time the program is reactivated, 
the P counter is set to return, and the ss 
field is set to 02. w must be .GE. 16 sec. 


-63- 


If O < w < 16 sec, FLOE uses 16 sec. 

If w=0, the suspension time is taken as 

20 minutes. If the w field is filled with 
all 1’s, then the suspension time is taken 
as 17.8 minutes. 


VVVVV the low-order 16 bits on the v field contain 
type-control information set by the sending 
device in the format: 


flebttttceccceck 


f (first bit) identifies this message as the first in a 
sequence of messages. 


1 (last bit) identifies this message as the last ina 
sequence of messages. 


(error bit) if the message cannot reach its destination, 
it is returned to the sender with the error 
bit set. 


fe) 


b (binary bit) if b=0 the message is a character string and 
FLOE has converted it from 8 to 6-bit 
ASCI:. If b=1 the message is a binary 
string and FLOE has not changed it. 


tttt type information. 
(type field) 


eeeccecee control information. 
(contro! field) 


k (chain bit) if k=l the first 48 bits of the first message 
word are treated as an extension of the header. 
Word beta + 2: Ppppp pnnnn 00090 00000 
where: pppppp is the machine-device identification number 


Remarks: 


associated with the next message if there is 
one (filled in by FLOEF). 


nnnn contains the number of words in the message 
delivered to the PP (filled in by FLOE). 


The dddddd field, filled in by FLOE with the machine-device 
identification number, contains 18 bits in the format: 


OOmmmmmmmmdddddddd 


where mmmmmmmm is the machine, and dddddddd is the device. Valid 
machine-device fields are (the numbers are octal): 


mmmmmmmm=2 0 PDP-10 concentrator for TMDS and file transport. 
For this value of mmmmmmmm, the dddddddd may be: 


dddddddd=1 File transport. 


dddddddd=3 TMDS . 
dddddddd=7_ + TMDS status display (system only). 
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mmmmmmmm=5 0 TMDS-II master computer. 


mmmmmmmm=5 1 TMDS-I! computer one. (Channels O through 177 
(octal).) 


mmmmmmmm=5 2 TMDS-11 computer two. (ChanneJs 200 through 377 
(octal).) For these three values of mmmmmmmm, the 
dddddddd should always be 0. 

mmmmmmmm=100 PDP-11 concentrator for RJET. (User-1 only.) 

mmmmmmmm=120 PDP-11 collector for RJET. (User-1 only.) 

mmmmmmmm=121 PDP-8 terminal for RJET. (User-1 only.) 

mmmmmmmm=122 PDP-8 terminal for RJET. (User-1 only.) 

mmmmmmmm=123 PDP-8 terminal for RJET. (User-1 only.) 


For these five valuesof mmmmmmmm, the dddddddd may 
be: 


dddddddd=0 Computer. 
dddddddd=1 Printer. 
dddddddd=2 Card reader. 
dddddddd=3 Teletypewriter. 


FLOE neither adds anything to nor deletes anything from a 
message from device. 


It is not possible to receive a message from a user terminal with 
this call. 


If a message from the PDP-10 concentrator (RJET, Elephant) is 
returned with the error bit set, the message "PDP10 DOWN” 
is returned to the PP: 

beta = 40777760446021200044B 

beta + 1 57675640777740020400B 


The PP gets a good return with ss=0. 
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2.27. Call 33: Interrupt Controllee for a Message or 


After a Time Interval 


This call may be used by a problem program to inform the system 
whether it does or does not want to be interrupted by the arrival of a 
message from controller, or wants to be interrupted after a specified 


time interval. 
Format: 


Word zero: 


where: aaaaaa 
Word alpha: 
where: 33 
nn 
return 
bbbbbb 
Word beta: 


(nn = 00,01) 


where: J11!11} 


00000 00000 1004a aaaaa or 
00000 00000 1005a aaaaa 


is the address of word alpha. 


33nnr eturn 0000b bbbbb 


nn=00 


nn=01 


nn=02 


nn=10 


nn=11 


nn=12 


is the code for this system call. 
indicates which option is desired: 


Any message from controller not 
preceued by a left—adjusted 
(CTRL-E)1. (*) 

(40020551B) will interrupt this 
problem program. 

Only messages preceded by a left-— 
adjusted (CTRL-E)1. (*) 

(40020551B) will interrupt this 
problem program. 

This problem program does not want 
to be interrupted by the arrival 

of a message from controlier. 
(Cancels previously set TTY 
interrupt.) 

Interrupt by transferring control 
to the P-counter address in word 
beta after this PP has run 

delta-t msec (see word beta, below). 
Like nn=01, but will be interrupted 
even though the job’s input bypass is set. 
Turn off the time interrupt flag. 


is the return address (see Sec. 1.2). 


is the address of word beta. 


00000 90000 00001 11111 


is the interrupt address, the address 
where the problem program is to be 
started when a message arrives from 
controller. 


*) Here (CTRL-E)1] represents simultaneously pressing the 
CTRL and E keys on the teletypewriter, followed by the 


1 key. 
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Word beta: OOOxx xxxxx OOOO! I1111 


(nn = 10) 
where: XXXXXxx specifies delta-t in msec (minimum 
delta-t is 4 msec). 

111111 is the value to which the P counter 
is to be set when the PP is 
interrupted. 

Remarks: 


1. The Interrupt Controllee system cal! must be issued 
again after the problem program has been interrupted if 
the problem program wants to be interrupted by the next 
message from controller. 


2. There will always be a message from controller waiting 
if the problem program is sent to l]1]1]11. 


3. The controller interrupt is treated like an 1/0 
interrupt. in order to release the controller 
interrupt the problem must issue the return from 
interrupt system call, described in Sec. 3.5. 


4. For nn = 01, the (CTRL-E) | is stripped off the 
message. The message is repositioned at the beginning 
of the word. 


5. For nn = 10, the time is updated every 3.6 msec. The 
PP must be running for the update to occur. 


6. The time interrupt option (nn = 10) must be reissued 
if the PP is to be interrupted after the next delta-t. 


7. ‘To release the time interrupt, the PP must issue the 
system cal] Return from Interrupt. (See Sec. 3.5.) 


8. For nn = 00 and nn = 01, the teletypewriter output 


buffer is cleared at interrupt by a message from 
controller. 
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2.28. Call 34: Run a Subordinate Job Within This 
Problem Program’s Field Length 


This call can be used to set up a control ler-—control lee—like 
relationship within a single problem program. It could be useful 
in a universal controller routine, or any routine in which it is 
desired to reduce the overhead of excessive controller-controllee 
disk swapping. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 
00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 3400r eturn ccessb bbbbb 
where: 34 is the code. to exchange to a new 


exchange package located within 
the FLS of this PP (this 
PP referred to as main job). 


return is the return address (see Sec. 1.2). 
ec is the word 1 option: 
ec=00 The subordinate job’s word 1 is 
not examined. 
cec=01 The subordinate job’s word 1 is 


looked at approximately every 3.6 


msec, and if it is nonzero, the main 
job is started (it appears to the main 


job that the subordinate job 

exchanged). The system sets 2 
high-order bits in the subordinate 
exchange package (word 8). 


ss is an error field, filled in by 


FLOE. (In the following discussion, 


(m) indicates the main job and (s) 
indicates the subordinate job.) 
Remark 1 for definitions of LCM, 
RAS, RAL, FLS, FLL. 


ss=01 beta is in LCM. 

ss=02 RAS(s) .LE. beta + 16. 

ss=03 RAL(s) .LE. beta + 16. 

ss=04 FLS(s) + RAS(s) .GT. FLS(m). 
ss=05 -FLL(s) + RAL(s) .GT. FLL(m). 


bbbbbb points to the subordinate job’s 
16-word exchange package: ‘ 


P-counter set by the main job; 
untouched by the system. 


RAS Set by the main job 


relative to RAS(m). 
It must be .GE. 
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bbbbbb + 16. 

The system changes 
RAS(s) relative to 
absolute machine zero. 

FLS Set by the main job; 
untouched by the system. 
FLS(s) must be .LT. FLS(m). 

PSD The 4 low-order~mode bits 
may be set. The 
condition bits are cleared. 

RAL Set by the main job 
relative to RAS(m). It 
must be .GE. 
bbbbbb + 16. The system 
changes RAL(s) relative to 
absolute machine zero. 

FLL Set by the main job; 
untouched by the system. 
FLL(s) must be .LT. 

FLL(m). 


NEA, EEA, and the 2 high-order-mode bits in the PSD are 
set by the system. The X, B, and A registers are unchanged. 


Remarks: 


1. Definitions: 
P-counter: program counter. 
RAS: relative address, small core. 
RAL: relative address, large core. 
FLS: field length, small! core. 
FLL: field length, large core. 
PSD: program status designator. 
NEA: normal exit address. 
EEA: error exit address. 


2. Since the RAS(s) and RAL(s) are changed by the system, 
the main job must restore this information every time it 
makes the 34 system call. 


3. NEA is set to point to the main job’s exchange package. 
Therefore, the main job starts running when the subordinate 
job issues a normal exchange. 


4. The system processes error exchanges from both the main job 
and the subordinate job. The main job may regain control 
by setting minus word 174 and word 2 (see Sec. 6.3). 


5. Information about the subordinate job is stored in minus 


word 175. Verification is made on every load from disk. 
Fatal error 240 results if the information is not correct. 
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3. CALLS TO EEA 


3.1. Charges 


A charge of 10 microseconds will be levied for all calls to 
EEA. 


3.2. EEA Call 01: Get a Clock Reading 


This call allows the user to get the contents of the 7600 
real-time clock. 


Format: 
Word zero: 00000 00000 uu0la aaaaa 
where: uu indicates which clock is requested: 


uu=01 means store the current reading 
of the 60-bit clock in location 
aaaaaa and transfer control to 
loc:..ion aaaaaa + 1. The 60-bit 
clock contains the number of elapsed 
microseconds since January 1, 1968. 
uu=02 means store the current reading of the 
LLL master computer clock in 
location aaaaaa and transfer control 
to location aaaaaa + 1. 


aaaaaa is the address of a particular core 
location. 


Remarks: 


1. The format for the LLL master clock (in bits) is: 


where: c= 1 means the clock is changing. 
nnnnn is months. 
dddddd is days. 
hhhhhh is hours. 
mmmmmmm is minutes. 
SSSSSSS is seconds. 
1111 is milliseconds. 
kkkkkkkk is year. 
jj} is day of week. 
p=c means power failure. 


iiiiiiii is the ASCII character for the 
machine identification (A). 


2. Except for the machine designation and the c and p bits, 
these bits contain a modified form of BCD (binary-coded 
decimal). Each group of 4 bits, counting from right to 
left, can contain the values 0000 (0) to 1001 (9). 
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3.3. EEA Call 02: Give up CPU-——Next Turn 


The requesting problem program wil! get no more CPU time 
until the problem program’s next turn in the alternator loop. 


Format: 
Word zero: 00000 00000 0002a aaaaa 
where: aaaaaa is the address where the problem 
program is to be restarted. 
Remarks: 
1. The “do not disturb” time is decremented by 12 msec. 


3.4. EEA Call 10: Give up CPU Until I/O Completes 


The requesting problem program will get no more CPU 
time until each of the specified input or output jobs has been 
completed. There are three options: (1) wait until all input 
and oulput is complete, (2) wait until a selected input or 
output is complete, and (3) wait until the next input or output 
request is complete. 


This sytem call is sometimes called “knowledge of completion,” 
or KOC. 
Format: 
Word zero: 00000 00000 ccl10a aaaaa 
where: cc specifies the type of request: 


cc=00 Give up the CPU until all 
input and output requests have 
been completed. 

ec=nn (1 .LE. nn .LE. 15): Give up the 
CPU until the input or output 
request specified by those 
10D’s whose c field (see 
Table 1 in Sec. 4.6) is equal 
to nn are completed. 

ec=40 Give up the CPU until the next 
input or output request has been 
completed. 


aaaaaa is the address where the problem 
program is to be restarted. 


Remarks: 

1. If ce = 00, the problem program is restarted at location 
aaaaaa when al! input and output for this program has 
finished. This call might be used at the end of a 
problem program when the problem program must wait until 
all output is finished before it signals that it has 
finished. 

2. If ce is a number between 1 and 15 inclusive, and this 
cal] is given while at the main program level, control is 
sent to location aaaaaa when all outstanding IOD’s with 
the identification number cc have terminated and the 


=<7i{= 


interrupt routine for the last such IOD has finished. 

If no interrupt routine has been specified, control is 
sent to aaaaaa after the 1/0 jobs in question have been 
completed. 

If cc is a number between 1 and 15 inclusive, and this 
call is given while in an interrupt mode, control is sent 
to aaaaaa after completion of all 10D’s with 
identification number cc. Interrupts are stacked and 
processed in the order received. 

In both cases described in Remarks 2 and 3, contingent 
10D’s with the same cc field are considered part of the 
chain and control is not sent to aaaaaa until they have 
also been completed. 

If cc = 40, the problem program is restarted at location 
aaaaaa when the very next interrupt routine has finished. 
If no interrupt routine was specified, control] is sent to 
aaaaaa after the input/output jobs in question have been 
completed. If a contingent 10D is specified instead 

of an interrupt routine, EEA picks up just before 
transferring control to aaaaaa. 


3.5. EEA Call 20: Return From an Interrupt Routine 


This cal! is for use with the FLVE Interrupt Controller 
system call described in Sec. 2.27 and with the interrupt 
options of input/output operations. 


Format: 


Word zero: 00000 00000 cc200 00000 


where: ce specifies the type of request: 


Remarks: 
1 


ec=00 Release the current interrupt and 
return to the zero level at the 
point of interruption, or take the 
next interrupt in the tist. All 
zero—level registers are preserved. 

ec=01 Release the current interrupt and 
make this the zero level which wil] 
be restarted at the location 
following the one from which the 
exchange to issue the call was 
made. This zero level will be 
started immediately if no 
additional interrupts have been 
stacked or after the Return from 
Interrupt has been issued for the 
last interrupt in the list. 


If this call is issued while at the zero level, i.e., 
not at an interrupt level, the problem program will be 
terminated with fatal error No. 216 (see Sec. 6.2.1). 
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3.6. EEA Call 30: Exchange Package Manipulation 


This call performs the following functions: 


Format: 


sets a breakpoint address or step-mode flag, 

returns the exchange package of the currently executing 
problem program to the problem-program buffer, or 
stores a specified exchange package into the currently 
executing problem program. 


Word zero: 00000 00000 uu30a aaaaa 


where: uu indicates the option: 


Remarks: 
1. 


uu=00 Set the breakpoint address in 
the exchange package if aaaaaa 
is nonzero. I|If aaaaaa is zero, 
set the step-mode flag in the 
PSD register (see Appendix E). 
Control is returned directly to 
the problem on completion of this 
option. 

uu=01 Store the executing exchange 
package into the problem-program 
buffer beginning at the address 
specified in the low-order 30 bits 
of word two. Control is trans-— 
ferred to word two on completion 
of this option. 

uu=10 Copy the exchange package located 
at the address specified in the 
Jow-order 30 bits of word two into 
the executing problem program 
exchange package. Control is 
returned to the address specified 
in the P-counter of the new 
exchange package. 


aaaaaa is the breakpoint address if 
uu = 00. 


For uu = 00, when the problem exits on breakpoint 

(P = BPA) or step, the step-mode and PSD condition 
flags are cleared, and contro] is returned to word two. 
lf word two is zero execution is terminated with fatal 
error 232. In this case word zero contains 


ccccp ppppp 00000 00000 


where: ccc is the 12 PSD condition bits. 
Pppppp is the P-counter. 


On completion for uu = 01, word zero contains the 
information specified in Remark 1, above. 

For uu = Q1 and uu = 10, if the address specified in the 
low-order 30 bits of word two is out of bounds or if the 
exchange-package buffer is not entirely in SCM or 

LCM, execution is terminated with fatal error 230. 
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4. INTRODUCTION 10 I/O REQUESTS 


4.1. General Information 


A problem program issues an I/O request when it requires 
input or output to be performed by the system. User programs 
may request to read or write tape or disk files, or to read 
from or write to the PDP-10. 1/0 programs available 
only to the system include ones to write the drum, read the 
card reader, and write flags to the PDP-10. 1/0 programs 
available only to the system include ones to write the drum, read 
the card reader, and write flags to the online printer. 


You issue an 1/0 request by storing a description of the services desired 
in a 4-word block called an “input-output descriptor (JOD)". You store in the 
second word (word one) of your program the address, zeta, of the beginning of 
this 4-word IOD. Then you issue an exchange jump to EEA, the resident executive 
program. FLOE gets control and examines word zero and word one of yovr program 
to determine what system call or I/O service is required. Once you issue an 10D 
you should not modify it until the 1/0 completes. 


4.2. Input/Output Connectors 


An 10D makes no direct reference to an I/O device. If 
a program could refer directly to an 1/0 device it would be 
possible for one program to interfere with another (by writing in 
the other’s disk file, for example). The interface between a 
program and an actual! I/O device is called an “input/output 
connector, or IOC.” 


An IOC is a 3-word block located in the program’s "minus 
words." Associated with every problem program is a block of 
230 (octal) words which is outside the program’s memory bounds and thus 
is not accessible to the program. For convenience, this block 
of words immediately precedes the program in LCM. The block 
is thus called the program’s minus words, since it resides before 
word zero of the program. Forty-eight of the minus words are 
devoted to 16 three-word I0C’s. See Appendix B for more details on 
program minus words. 


For the problem programmer, the number of a particular IOC 
serves as a symbolic name for an 1/0 device. When a program 


desires to use an 1/0 device, e.g., a disk file or a tape, it 
must request the device from FLOE and specify an associated 
10C number. If the device is available to the requesting 


program, FLOE stores information describing the device in 

the specified I10C. Thereafter, when the program needs to 

use the device, it refers in the IOD to this IOC number. 

The IOC thus serves as a map between the programmer’s logical 
names and the system’s absolute physical addresses and locations. 


Appendix C gives details about the IOC format. 
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4.3. Examples of How to Issue an I/O Request 


This section gives examples of two ways to issue an 1/0 
request. We show first how to construct the 10D from the 
format information in Sec. 4.6 and how to issue the request 
in a Fortran program. Then we show an easier way to issue the same 
1/O request using ORDERLIB (Ref. 2) subroutines. 


The 1/0 task we consider is to write 1000 (octal) words of information 
to disk, starting at (relative) disk location 0; the information 
is contained in a buffer named BUF. See Sec. 5.10 
for details of the disk-write 1/0 program. 


THE HARD WAY. Figure 4 shows Fortran coding to issue 
this 1/0 request the hard way: the zeta words are set in lines 
4 to 7. In lines 8 and 9, word 1 is set to the address of 
ZETA and an exchange instruction is issued. This is 
fairly straightforward. What is not obvious is how to fill in the 
zeta words so that the system takes the desired action. 


Refer to Table 1 in Sec. 4.6. This table shows two 
possible formats for the four zeta words in an IOD. 10D’s for certain 
1/0 tasks can be issued in either an 18-bit or a 19-bit format; 
this choice applies to reading or wri'‘ng disk, drum, and odd-parity 
(binary) tape. For all other 1/0 tasks the 18-bit JOD format is 
used. Since we are requesting a disk-write operation, we must first 
choose which format to use. 


Line ZETA words 

No. Fortran coding (octal) 

1 ALL INTEGER 

2 ABSOLUTE ZERO (0), ONE (1) 

3 DIMENSION ZETA (4), BUF (1000B) 

4 ZETA = 5130007B .SHL. 36 0513 0007 0000 0000 0000 
5 ZETA(2) = 1 .SHL. 59 4000 0000 0000 0000 0000 
6 ZETA(3) = (10000B.SHL.27).UN.(.LOC.BUF) 0000 0000 0010 000b uffe 
7 ZETA(4) = 0 0000 0000 0000 0000 0000 
8 ONE = .LOC. ZETA 

9 CALL Q8EXCH 


Fig. 4. Example of Fortran coding to issue a disk-write I/O 
request the hard way. In word ZETA, 0513 is the code 
for disk write, and 07 specifies IOC No. 7. In word 
ZETA(2), 4000 shows the "busy" bit. In word ZETA(3), 
0010 00 is the word count, and the numbers in field “b uffe” 
will specify the location of the buffer. 


The 18-bit format was retained on the 7600 for compatibility 
with the 6600. The terms 18-bit and 19-bit apply to the 
y,. t, and i address fields (see Table 1). The i and t fields have 
to do with chained 1/0 requests and will not concern us here. 
The y field specifies the size of the central memory buffer, i.e., 
the word count for the read or write operation. We will use the 


19-bit format in our example. We suggest that you routinely use 
19-bit 10D’s. 
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To construct the zeta words we !ook at Table 1 and read the 
description of each bit field in Sec. 4.6, deciding if each field is 
needed to describe our particular I/0 job. In this way we find that 
only the a and d fields in word zeta are needed. The a field identifies 
the 1/0 service being requested; in our case a = 0513 (octal) , the 
code for disk write. The 07 in the d field tells the system to use 
IOC number 7 in the program’s minus words. (We assume that a disk file 
has: been created previously using IOC 7.) 


The only field we use in word zeta + 1 (i.e., ZETA(2) in 
the Fortran) is the u bit. This is termed the “active” or “busy” bit. 
because the system turns this bit off when the !/0 job is completed. 
If you set this bit before issuing the !OD, you can query 
it to sense when the I/O finishes. 


Word zeta + 2 contains the 19-bit word count (the y field) 
and the location of the buffer in the program from which the 
information will be written to disk (the z field). This 
address is represented in Fig. 4 by “buffe” (line 6). 


Finally, the fields in word zeta + 3 are not needed for our 
simple disk-write operation, so this word is set to zero. 


THE EASY WAY. Many people find it easier to issue [/0 
requests by calling subroutines FROSTCLICHE/FROSTCALL/FROSTIO. (Ref. 4.) 
These subroutines are available in the ORDERLIB library (Ref. 2). 
Figure 5 shows the subroutine calls necessary to issue our disk-write 
request. 


The statements in lines 3 and 4 give access to the common block, 
called JOCOM, used by FROSTIO for its “zeta words." SETIO 
is used to set up our 10D, while the actual request is issued by 
acal}] to REIO. The 7’s in the first and fourth arguments to 
SETIO represent the !0D number and the IOC number, 
respectively; for convenience these numbers are usually sei to the 
same value. The other arguments to SETIO specify the buffer 
size, the buffer location (i.e., variable name BUF), and the 
code for a disk-write request. 


1 ALL INTEGER 

2 DIMENSION BUF(1000B) 

3 PARAMETER (NIOD = 16) 

4 COMMON / IOCOM / IEOP(NIOD), IOD(4,NIO 
3 CALL SETIO(7, 1000B, BUF, 7, 513B) 

6 CALL REIO (7, 0, 0) 


Fig. 5. Fortran coding to issue a disk-write I/0 
request the easy way, using entry points to the 
ORDERLIB routine FROSTIO. For details on this 
routine, see Ref. 4. 
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4.4. Chained I/O Requests 


1/O requests may be chained~-that is, a number of requests may 
be submitted by issuing a single exchange jump instruction. There 
are two kinds of 1/0 chains: contingent and simultaneous. 


In contingent I/O chains each IOD can specify the location 
of another IOD to be submitted only after this I/0 job 
completes. Contingent chains are also called "“i-field chains”, 
since the location of the contingent IOD is given in the i field 
of an IOD (see Sec. 4.6). 


In simultaneous 1/0 chains (also called “t-field chains”: 
see Sec. 4.6) an IOD can specify the location of another I0D 
to be issued at the same time as this 1/0 job. Requests for the 
same device are processed in the order received. 


Up to 32 requests can be submitted at one time. An I/O 
chain can be initiated by either the i or t field, and can 
contain a mixture of i- and t-field chains. See Sec. 4.6 for 
more details. 


4.5. Scheduling 1/0 


With several programs in the alternator loop at one time, 
conflicting demands arise for use of the !/0 channels. The 
resident 1/0 programs, therefore, must schedule 1/0 jobs 
so that conflicts are avoided. 


For nondisk 1/0 the scheduling is very simple. For each 
nondisk channel the resident 1/0 maintains a list of jobs to be 
executed. Each list is processed in the order the jobs are 
submitted, except jobs for which magnetic tapes are currently 
rewinding. These jobs are temporarily bypassed in favor of jobs for 
other tapes until the rewind has been completed. 


This manner of scheduling would, however, lead to extremely 
inefficient use of the disks, since head motion is slow (50-150 msec). 
For this reason the list of jobs for each disk channel is ordered 
according to the head position where the job is to be started. 

Once the heads are at a given position, al! the jobs for that head 
position are executed before the heads are moved. This has the 
effect of eliminating much unnecessary head motion. 


4.6. Format of an Input Output Descriptor (IOD) 


Table 1 shows the format for 18-bit and 19-bit 10D’s. The 
meanings of the various bit fields are explained below. 


1/O requests that can be issued with 19-bit 10D’s are requests 
to read (a = 0410) or write (0411) binary tape, read (0412) or 
write (0413) disk, or read (0414) or write (0415) drum. In Table 1 
note the 1 bit in the a field of word zeta. This bit indicates 
that a 19-bit IOD is being used, since it implies that the a field 
will have a value between 0510 (octal) and 0515 (octal). The 19-bit 
format is required if the i, t. or y fields (see below) exceed 18 bits. 
We suggest that you routinely use the 19-bit format. 
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Table 1. 11-bit and 19-bit IOD formats (binary). 
18-Bit IOD Format 
Word zeta: 
aaaaaaaaaaaa rrvephk—-dddd I!---—-—-ccce —-———Cttttt tttttttetttt 
Word zeta + 1: 
u-ssssssssss bbbbbbbbbbbb ma OXXXKXXNXXXXK NRXXXXXAXXXXXX 
Word zeta + 2: 
REBEEEREBEEE BEEBEBEEEEBE ~YYYYYYYYYYY YYYYYY~Z2222 222222222222 
Word zeta + 3: 
f(r°f°rrf°rfr¢ff¢f j---—- Giiiii PIPPI) n-——~—mmmmmm mmm 
19-Bit IOD For..at 
Word zeta: 
aaaaalaaaaaa rrvephk-—dddd —wwww-——cccce —-———ttttttt tbeeettteitet 
Word zeta + 1: 
u-ssssssssss bbbbbbbbbbbb —————— S8EBSe Beeeeeeeeeee Beeeeeeeceee 
S35 eae = pea yea wee XXXXXAXRAXXXXX 
Word zeta + 2: 
Rena Sa soos SSS YVYYYYYY YVYYYYYYYVYY -----ZZZZZZzZ ZZZAZZZAZZAZLZ 
Word zeta + 3: 
frf°frerrcfrftff j—-—iiiiiii iiiiiiiiiiii n—-——mmmmmm ommomemen 


The rest of this section describes the content, 
of the various bit fields in the IOD formats. 


a This field specifies the type of 1/0 job to be 
1/O program has a number associated with it. 
descriptions of the individual I/O programs in 
to 5.21. 


b This field is incremented by one each time the 
completed. 


meaning. or use 


done. Each 


See the 


Secs. 5.1 


10D is 


The 1/0 programs do not examine this field. 


A twelve-bit twos-complement addition is performed. 


c The 
program is given 
used in connection with EEA cal] 


in this 4-bit field. 
10, 
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10D identification number assigned by the problem 
This number 
the Give Up CPU 


is 


until 1/0 Completes system call (see Sec. 3.4). 

When a problem program issues a Give Up CPU call, the program 
is not resumed until the completion of all I/O requests 

whose eccce (binary) IOD fields equal the ce (octal) field 

of the Give Up call. 


This 4-bit field contains the IOC number. It indicates 
which of the 16 10C’s in the problem programs minus words 
contains a description of the 1/0 device needed by this 
1/O request. 


(System use only.) This bit is used in conjunction with the 
v bit (see below) to indicate that the address for the pattern 
disk write is in sectors. See Sec. 5.10 for more details. 


This 12-bit field is used to return an error message. If 
the I/O operation was completely trouble-free the f field 
will contain a zero; otherwise an error number wil] be stored 


in it. The error numbers and their meanings are listed in 
Sec. 6.2. 


This is a general-purpose field. If the 1/0 device is 

a disk, g contains the first-word address for the disk operation. 
lf the device is not a disk, the meaning of the g field 

varies, and is described with each individual 1/0 program. 

For some 1/0 programs the g field is not used (a=0414/0514, 
0415/0515, and 0520-2012); in these cases the problem program 
may use this field to store any desired information. 


(System use only.) This bit is used with drum-write l10D‘s. 
If h = 1 the system accepts a 5-word 10D; the Sth word 
has the (octal) format: 
0000 xxxx 0000 yyyy zzzz 
where: xxxx is track number (12 bits); 
yyyy is sector number (12 bits); and 


ZZZZ is word number (12 bits). 


This field is used for one of two purposes, depending on the 
j bit: 


(1) If j = 0 then i specifies the address of an interrupt 


routine that will be entered after this request 
completes. 
(2) If j = 1 then i specifies the address of a “contingent 


10D" to be examined and processed only after this 
1/0 request has completed. This allows you to 

set up simple contingency of one I/O job on another 
without coding special interrupt routines. 


This bit is a flag to determine the meaning of the i field. 


If j = 1 (and is nonzero) then the i field is interpreted 
as the address of a contingent IOD. If j = 0 
(and i is nonzero) then i is taken as the address of an 


interrupt routine. Once the interrupt routine for this 
JOD has been entered, al] interrupts from other 10D’s 

(for this problem program) are inhibited until this 
interrupt completes. 
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(System use only.) If k = 1! and the a field is between 

2000 and 2012 (i.e.. if this is an IOD to manipulate a tape, 
except to read or write one), then the second and third words 
of this IOD (words zeta + 1, zeta + 2) are used as an I0C 

for this request. 


If | = 1 and a = 2002 (Rewind and Unload and/or 

Disconnect Tape), then the tape unit is disconnected. If 

1 = 0 the tape is rewound and unloaded and the tape unit is 
disconnected. 


This field is used for error contingencies. It has one of 
two meanings, depending on the n bit: 


(1) If n = 0 then m specifies the address of the program’s 
error-interrupt routine. This routine is entered if 
the IOD suffers an error. 


(2) If n = 1 then m specifies the location of an IOD 
to be examined and processed in case of an error. 


If the m field is void it specifies no action. 


This bit is a flag to determine the meaning of the m field. 
If n = 0 (and m is nonzero) then the m field is interpreted 
as the address of an error-interrupt routine. If n= 1 
(and m is nonzero) then m is taken as the address of an 

10D to be submitted in case this 1/0 request sustains 

an error. Once the error-interrupt routine (specified 

by the m field, n = 0) for this IOD has been entered, 

all interrupts from other IOD’s (for this problem 

program) are inhibited until this error-interrupt routine 
completes. 


(System use only.) This bit is used with drum-write 1/0 
requests. If p = 1 the peripheral processing unit will not 
automatically verify the write. 


This field is only used with disk-write 10D’s. If the 
initial address and/or the final address of a disk write is 
not a multiple of 1000 (octal), the disk-write programs must 
read the partial sectors. If it is known that the 
unreferenced portions of the partial sectors need not be 
preserved, the reading step may be bypassed and the writing 
process speeded up. 


rr = 00 means preserve the unreferenced portions of the 
first and last sectors specified in the disk-—- 
write IOD. 
rr = 01 means preserve the unreferenced portion of the 
first sector. 
rr = 10 means preserve the unreferenced portion of the 
last sector. 
11 means do not preserve the unreferenced portions of 
either the first or last sectors specified in this 
disk-write IOD. 


rr 


This 10-bit field is reserved for programmer information. 

The information in the s field is returned in register AO 
upon normal completion (EOP interrupt) or error interrupt. 
This information could be used in a general interrupt routine. 
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4.7. 


This field specifies the address of another IOD that is 

to be submitted at the same time as this one. A chain of 
!10D’s can thus be submitted by using the t field. Such 

a “simultaneous 1/0 chain” differs from a contingent (i-field) 
chain in that the t-field chain is not necessarily ordered. 
Requests specifying the same device are processed in the order 
received. 


Any IOD chain can be initiated by either the i or the t 
field, and can contain a mixture of i- and t-field chains. 


This is the active bit or “busy” bit. The u bit is 
cleared by the I/O termination routine when the job is 
completed. You can set this bit before the IOD is 
submitted and query it to determine when the 1/0 finishes. 


This bit is used only with disk-write 1/0 requests. If 

v = 1 the PPU writes a specified 12-bit pattern ina 
specified disk file. There is a special! format for the third 
word of the 10D in this case; see Sec. 5.9 for details. 


(System use only.) This 4-bit field, present only in the 
19-bit !0D format, is used for card-reader and PDP-10 

1/O requests. See Sec. 5.5, 5.12, and 5.13 for the use 
of the w field. 


This field may contain parameters returned by an 1/0 
program to the problem program. See the descriptions of 
the individual 1/0 programs in Sec. 5. 

This field specifies the size of the central memory buffer. 
This field specifies the location of the central! memory 


buffer. 


Difference Between Seven—Track and Nine—Track Tapes 


The difference between the seven-track and the nine-track tapes 


is that seven-track tapes can be written with either even or odd 
parity, while nine-track tapes are always odd parity. (The parity 
bit is the seventh bit on the seven-track tapes and the ninth bit on 
the nine-track tapes, and it is used for error checking.) Therefore, 
when reading or writing nine-track tapes, the even-parity tape 

1OD’s (A = 2, and A = 15) will imply conversion between 6-bit 

ASCI1] and EBCDIC. The odd-parity-tape IO0D’s will imply 

no-conversion on the data. 
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5. INPUT/OUTPUT PROGRAMS AVAILABLE 


5.1. General Information 


This section lists the 21 I/O programs available to the user 
and to the system. Some miscellaneous comments on the operation of 
several of these 1/0 packages are given immediately below. 


1. When a parity error is encountered in reading a tape, the 
PPU does not attempt to reread it. The tape is left 
positioned at the far side of the bad record. The 
information in the record is left in central memory. 


2. <All the routines that read or write tape are oriented to 
single records. 


3. The tape-read routines read under record control. That is, 
the PPU reads a single record and transmits it to central 
memory. If the number of CPU words in the record 


exceeds the size of the buffer specified in the IOD, 
the PPU transmits as many words to central memory as wil] 
fit, and signals an error (0004) in the f field. 


4, If you try to perform any tape function involving forwara 
motion in the approximately 20 feet of tape after the 
end-of-tape reflector, the end-of-tape error (f = 0010) 
will always result. If any other errors are present 
their numbers will be OR’d with this number. 


5.2. Write Online Printer (System Only) 
aaaa = 0001 (18-bit format) 


This program prints a packed-ASC!I}] drum file on the online 
printer. The program is reserved for system use only. 


The z field contains the location of the four-word file 
identification. The y field contains the file size and the ge field 
contains the starting address on drum. Field g must be a multiple 
of 128. 


5.3. Read Even—Parity (BCD) Tape 
aaaa = 0002 (18-bit format) 


One entire record is read each time this 1/0 program is used. 
When the 1/0 job is completed, the g field and the x field of the 
10D contain the number of 12-bit bytes (that is, the number of 
PPU words) that were transmitted to central memory. 


One caution is in order here. An end-of-file mark is treated 
as a record by the tape-read program; that is, if an end-of-file 
error is returned in the f field then no data was read. However, 
when an end of file is encountered the x field is not updated. If 
you simply check the x field to monitor the progress of a tape read 
you could be misled. 
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Field y of the IOD specifies the buffer length. This 
length is interpreted as an upper limit on the number of words to 
be read. This upper limit will never be exceeded by the 1/0 
program. 


If n represents the number of words actually in a record, one 
of three cases can result: 


(1) If n .EQ. (field y) then 5 * n is stored in fields e and x. 

(2) If n .LT. (field y) then 5 * n is stored in fields g and x. 

(3) If n .GT. (field y) then 5 * x (field y) is stored in 
fields g and x. 


In case 3, an error is set in the f field indicating that the buffer 
was not large enough. 


When reading 9-track tape. the high-order bit of field x will be 
set if the number of 12-bit bytes transmitted is an even number and the 
last 6-bit byte was filled in by the hardware rather than being read 
from tape. 


If field g is not used, and field y specifies an odd number of 
60-bit words, the last four bits will be lost. 


5.4. Write Even—Parity (BCD) Tape 
aaaa = 0015 (18-bit format) 


If field g of the 10D is zero, the number of 60-bit words 
to be written is taken from field y. If field g is nonzero, the 
number of 12-bit words to be written is taken from field g. Fieid 
g must not exceed five times field y. 


See Table Al in Appendix A for the character conversion 
performed by this !/O program. 


If a bad spot is encountered the record is not automatically 
rewritten. You must check the f field for errors and take action 
appropriate to your need. 


If the end-of-—tape error is returned (f = 0010) then the record 
that was written is good. 


When writing 9~track tape, if the high-order bit of field g is 
set and field g specifies an even number of 12-bit bytes, the last 
8-bit byte in the data field will not be written on tape. 


If field g is not used, and field y specifies an odd number of 
60-bit words, the last four bits will be lost. 
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5.5. Skip Tape Records 
aaaa = 0016 (18-bit format) 


The action of this program is controlled by the g field, as 
follows: 


g = 0000nnnn means skip n records backward. 
g = 4000nnnn means skip n records forward. 
g = 70-—---- means skip backward to end-of-file. 
g = 60------ means skip forward to end-of-file. 
The routine returns an error for all four cases if an end-of—-file 


is encountered while skipping. The number of records actually 
skipped is returned in the x field of the IOD for the first two 
cases (g = 0000nnnn or g = 4000nnnn). 


5.6 Read Card Reader (System Only) 
aaaa = 0017 (18-bit format) 


This program reads an ID card into the buffer specified 
by the z field if the w field is zero; or it reads a card deck into 
the drum file specified by the g field if the w field is nonzero. 
The g field must be a multiple of 128. The program is reserved 
for system use only. 


The y field contains the maximum file size when the IOD is 
issued. This field will contain the actual file size encountered 
when the IOD is completed. The w field, when nonzero, specifies 
the file type: 


wel Packed ASCI1!. 

w= 3 Monitor squoze. 

wad Absolute. 

w= 17 Bad ID Card. Deck will be read through the card 
reader. 


5.7. Read Odd-—Parity (Binary) Tape 


aaaa = 0410 (18-bit format) or aaaa = 0510 (19-bit format) 


One entire record is read each time this I/O program is 
used. When the 1/0 job is completed, the g and x fields of the 
10D contain the number of 12-bit bytes (that is, the number of 
PPU words) that were transmitted to central! memory. 


Field y of the 10D specifies the buffer length. This 
length is interpreted as an upper limit on the number of words to be 
read. This upper limit will never be exceeded by the I/O program. 


!f n represents the number of words actually in a record, one 
of three cases results: 


(1) If n .EQ. (field y), then 

(2) If n .LT. (field y), then 

(3) If n .GT. (field y), then 
g and x. 


* n is stored in fields g and s. 
* n is stored in filds g and x. 
* x (field y) is stored in fields 


ogo 


In case 3, an error is set in the f field indicating that the buffer 
was not large enough. 


When reading 9-track tape, the high-order bit of field x will be 
set if the number of 12-bit bytes transmitted is an even number and the 
last 8-bit byte was filled in by the hardware rather than being read 
from tape. 


lf field g is not used, and field y specifies an odd number of 
60-bit words, the last four bits will be lost. 


5.8. Write Odd—Parity (Binary) Tape 
aaaa = 0411 (18-bit format) or aaaa = 0511 (19-bit format) 


If field g of the IOD is zero, the number of 60~—bit words 
to be written is taken from field y. If field g is nonzero, the 
number of 12-bit words to be written is taken from field g. Field 
g must not exceed five times field y. 


If a bad spot is encountered the record is not automatically 
rewritten. You must check the f field and take action appropriate 
to your needs. 


If the end-of-tape error (f = 0010) is returned, then the record 
that was written is good. 


When writing 9-track tape, if the high-order bit of field g is 
set and field g specifies an even number of 12-bit bytes, the last 
8-bit byte in the data field will not be writen on tape. 


if field g is not used, and field y specifies an odd number 
of 60-bit words, the last four bits will be lost. 


5.9. Read Disk 
aaaa = 0412 (18-bit format) or aaaa = 0512 (19-bit format) 


At the end of the operation, the x field contains the number of 
60-bit words (the CPU word count) for this read. 


If g is greater than the file size, error 4004 (out-of- 
bounds disk reference) is placed in the f field and the program 
is killed. 


If g is not greater than the file size but g + y is greater, 
then error 0020 (end of file) is placed in the f field and the number of 
words read (filesize — g) is placed in the x field). This number 
will be greater than zero but less than y. Data up to the end 
of the file are transmitted. 


5.10. Write Disk 
aaaa = 0413 (18-bit format) or aaaa = 0513 (19-bit format) 


If the v field is zero this 1/0 program writes specified data 
to disk. 


If g is greater than the file size, 4004 (out-of-bounds disk 
reference) is placed in the f field and the program is killed. 


If g is greater than the file size but g + y is greater, 0020 
(end of file) is placed in the f field and the number of words 
written (filesize ~ g) is placed in the x field. This number wil] 
be greater than zero but less than y. Data up to the end of the 
file are transmitted. 

If the v bit equals 1 the PPU writes a specified 12-bit 
pattern into any specified portion of the disk file. The third 
word of the IOD has a special format for this case, given by: 
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“GEEEREEEELE SELEELELLELE PPPPPPPPPPPP ———YYYYYYYYY Yyyyyyyyyyyy 


where: 
ge-.-.g is the first disk word address for the write operation. 
pp...p is the 12-bit pattern to be written in the disk file. 
yy...-y is the number of 60~bit words to be filled with the 
desired disk pattern pp...p. This number must be a 
multiple of 1000 (octal). 
This use of the disk write I/O program allows you to clear 
all or part of a disk file, or to write a given pattern in the disk 
file, without creating a buffer in the problem program’s storage. 
If the e bit equals 1 the gg...g field in the IOD is taken as 
the first sector address for the write operation (system use only). 
5.11. Read Drum (Restricted Use) 
aaaa = 0414 (18-bit format) or aaaa = 0514 (19-bit format) 


Fields g and y must be multiples of 128. This program is for 
system use only. 


5.12. Write Drum (Restricted Use) 
aaaa = 0415 (18-bit format) or aaaa = 0515 (19-bit format) 


Fields g and y must be multiples of 128. This program is 
for system use only. 


5.13. Read PDP-10 
aaaa = 0516 (19-bit format) 
This program reads data from the PDP-10 file channel. 
The w bit is zero for data and one for contro! information. 


The PPU word count (12-bit words) is returned in the x field 
on completion of 1/0 job. 
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5.14. Write PDP-10 
aaaa = 0517 (19-bit format) 

This program writes data on the PDP-10 file channel. 

The w field bit is zero for data and one for control 
information. 
5.15 Write BRATS (TMDS-II) 
aaaa = 0523 (19-bit format) 

If field g of the IOD is zero, the number of 60-bit words to be 
written is taken from field y. If field g is nonzero, the number of 


8—-bit bytes to be written is taken from field g. 


If field g is not used, and field y specifies an odd number of 
60-bit words, the last 4 bits will be lost. 


The upper-order 17 bits of word 3 of this IOD are defined as 
follows: 


0000000000000000x 
where: 
x if one, indicates that the first 12 bits of each 540—-bit block 
of data are to be omitted. 
5.16. Read Tape—Unit Status 
aaaa = 2000 (18-bit format) 
The tape-unit status is returned in the z field of the IOD. 
Multiple status states are logically added together; for example, 


z = 0005 indicates: 1) the tape unit is ready, 2) there is a ring 
in the tape, 3) the tape density is set to 200 bpi. 


-—-—-1 Ready. 

---2 Busy. 

---4 Write enable (there is a ring in the tape). 
-—-1-— Filemark. 


-—-2- Load point. 
-—-4-— End of tape. 
-0-- Density 200 bpi. 
-1-- Density 556 bpi. 
-2--— Density = 800 bpi. 


-4-— Lost data. 

1--- End of operation. 

2-—— Parity error. 

4--— Unit reserved by other channel. 


5.17. REWIND TAPE 


aaaa = 2001 (18-bit format) 
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5.18. REWIND AND UNLOAD AND/OR DISCONNECT TAPE 
aaaa = 2002 (18-bit format) 

If 1 = 0 the tape is rewound and unloaded. and the tape 
unit is disconnected from the problem program. If 1] = 1 the 


tape unit is disconnected, but the tape is neither rewound nor 
unloaded. 


5.19. WRITE FILEMARK 


aaaa = 2003 (18-bit format) 


5.20. WRITE BLANK TAPE 
aaaa = 2004 (18-bit format) 


Six inches of blank tape are written. 


Seels SET DEMSIFY TO. 200 Opi 


aaaa = 2010 (18-bit format) 


5.22. SET DENSITY TO 556 bpi 


aaaa = 2011 (18-bit format) 


5.23. SET DENSITY TO 800 bpi 


aaaa = 2012 (18-bit format) 


5.24. SET DENSITY TO 1600 bpi 


aaaa = 2013 (18-bit format) 
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6. ERROR INDICATIONS 


6.1. Standard I/O Error Messages (f Field Numbers) 3 


The following values are placed in the f field of the IOD 
as the occasion demands: 


0000 = No errors. 

000i = Device not ready, or not responding to status request. 
0002 = Parity error. 

0004 = Data exceeds programmer’s buffer. 
0010 = End of tape. 

0020 = End-of-file condition. 

0040 = Attempt to write file-protected tape. 
0100 = Channel failure. 

0200 = Lost data on tape record. 

0400 = Attempt to backspace over joad point. 
1002 = Disk positioning error. 

2001 = Tape reserved by another channe]. 


In the event of more than one error, the above numbers are 
logically added together. 


4001 = Channel number in [OC invalid. 

4002 = Out-of-bounds memory reference. 

4003 = Improper minus word. 

4004 = Out-of-bounds disk reference. 

4005 = Illegal !0D -- zero word count requested. 
4006 = Illegal IOD —— IOD and minus word do not check. 
4007 = Illegal IOD -— t field points to self. 

4010 = Illegal !0D --— a field not valid. 

4020 = Channel is down. 

4040 = Attempt to write file-protected disk. 

4041 = Attempt to read higher protection level file. 


Note that all! errors greater than 4000 are programmer errors. 
They are considered irremediable by FLOE and cause the program 
to be killed unconditionally. Thus the program need not examine 
the upper bit of the error field: it will always be zero if the 
program is running. 


6.2. Miscellaneous Problem Program Error Messages 


The following codes may appear on the teletypewriter preceding 
the “all done“ mesage. Any of these codes indicates that the 
problem program has been killed (that is, removed from the alternator 
loop) and placed back on disk. 


The formats of the error messages listed here are identical] * 
character-by-character to the messages put out by FLOE (except 
that upper and lower case are used here for clarity). bs 
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6.2.1. 


200 
201 
202 
203 


PP Errors Not Involving an IOD 


Under f low 

Overflow 

Indefinite 

Program range. P counter equals zero or a (00) instruction 
has been issued. 

SCM direct range. P counter or SCM ref. equals or 
exceeds FLS. (not block copy) 

LCM direct range. LCM ref. equal or exceeds FLL. 

(not block copy) 

SCM block range. SCM ref. equal or exceeds FLS using 
block copy inst. 

LCM block range. LCM ref. equal or exceeds FLL 

using block copy inst. 

SCM parity 

LCM parity 

Illegal system call —- word O bad or high order 6 bits of 
alpha bad 

Alpha out of bounds 

Beta out of bounds 


PP requested to return from interrupt when already at main level 


KOC* restart address points out of bounds 

1/0 request (word!) points out of bounds 

Too many [ODs listed when adding PF to alternator loop 

10D address out of bounds when adding PP to alternator loop 
PP called for too many exchange jump packages 

Invalid exchange package linkage 

FLS or FLL exceeds filesize-230B 

PP exchanged with word0=word1=0 

FLS exceeds 157760B or FLL + 230 (octal) exceeds 1414600B 
XJP address (word2) points out of bounds 

Static memory con. bounds fault. (See minus word 204 octal) 
Exit on breakpoint or step with word 2 = 0 

Return field (FLOE call) = 0 or points out of bounds 

Chain call field (hi order 30 bits of word 0) points out 

of bounds 

Channel No. in IOC and channel No. file is on, do not agree 
File is type data. Execution not allowed 

Teletyre interrupt address points out of bounds (minus word 
271 octal) 

Subordinate exchange package not correct (minus word 175B) 
Time interrupt P counter points out of bounds (minus word 
173B) 

FLS .GT. FLL 


*) KOC means “knowledge of completion"; this is another term for 
EEA Cal] 10, Give Up CPU until 1/0 Completes. See 
sec. 3.3% 
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6.2.2. Errors Involving an IOD 


300 Incorrect minus word. I]legal channel No. 

301 Requested nonexistent I/O program. Illegal A field 

302 I!10D and 10C word not compatible 

303 T field of 10D points out of bounds 

304 PP has submitted too many [ODs (.GT. 31) 

305 PP has submitted too many IODs for one device (.GT. 15) 

306 PP error detected by slave PPU while executing an JOD. 
Examine F field 

307 Address of contingent !OD is out of bounds 

310 Interrupt address is out of bounds 

311 Zero disk length 

312 1/0 out of bounds memory reference 

313 Out of bounds disk reference 

314 Zero word count requested 

315 T field points to self 

316 Attempt to write file protected disk 

317 Channel down 

320 Read access denied 


6.3. Recovering Control After a Hardware Error 


There are two ways a problem program may recover contro! after 
a hardware error: 

(1) If the PP’s word 2 is nonzero, control is returned to 
word 2 after the arithmetical errors, breakpoint, and step. 

(2) By setting minus word 174 (octal) you may selectively choose 
which hardware errors (excluding parity) you would 
like to recover control of. This takes precedence over 
the convention described in (1) above. Control is 
returned to word 2 if this word is nonzero and minus word 
174 is set as follows: 


50434 04350 43504 3xxxx 


where xxxx is a mask that will be intersected with the 
condition bits in the PSD register (see Appendix E) 
after a hardware error. Control is returned to the 
problem program if the hardware error’s corresponding 
mask bit is nonzero. Otherwise, a fatal error results 
and the problem program is killed. 


For both cases (1) and (2), if the low-order 30 bits of word 2 
contain a number n = 0, then the current exchange package is copied 
beginning at location n. Fatal error 230 results if n + 15 is 
out-of—bounds or is not entirely in SCM or LCM. Except after 
exit on step, the problem program’s word zero will contain: 


ccecp ppppp rrrrrorrrrr 
where: ceec=condition bits in PSD. 


Pppppp=P-counter. 
rr...r=(previous contents). 
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APPENDIX A: ASCII AND TAPE BCD 


The Write Even~Parity (BCD) Tape 1/0 program converts the 
ASCII characters in the core memory to tape BCD format, as shown in 
Table Al. See Sec. 5.3 for details about this 1/0 program. 


Table Al. Character conversion done by the Write BCD Tape 1/0 
program (a=0015). 


ASCII Char- Tape ASCII Char- Tape 
code acter BCD code acter BCD 
00 (space) 20 
01 ! 17 41 A 61 
02 " 57 42 B 62 
03 # 20 (a) 43 Cc 63 
04 $ 53 44 D 64 
05 % 72 45 E 65 
06 & 52 46 F 66 
07 2 14 47 G 67 
08 ( 34 50 H 70 
11 ) 74 31 I 71 
12 * 54 52 J 41 
13 + 60 53 K 42 
14 ’ 33 54 L 43 
15 40 55 M 44 
16 . 73 56 N 45 
17 / 21 57 9) 46 
20 0 12 60 P 47 
21 1 01 61 Q 50 
22 2 02 62 R 51 
23 3 03 63 Ss 22 
24 4 04 64 T 23 
25 5 05 65 U 24 
26 6 06 66 Vv 25 
27 7 07 67 W 26 
30 8 10 70 X 27 
31 9 11 71 Y 30 
32 : 32 72 vA 31 
33 7 56 73 f 16 
34 < 35 74 \ 76 
35 = 13 75 3 15 
36 > 55 76 t 77 
37 ? 37 77 « 75 
40 @ 36 


(a) The 03 symbol (#) is written as a space (blank, 20B). When read, 
this 20B is read as a blank. Thus the original # symbol! is lost. 
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APPENDIX B: MINUS WORDS 


A block of 230(octal) words, used for system functions, is associated 
with every problem program. These words (residing outside the PP’s memory 
bounds) are located immediately before word zero in LCM; thus they are 
called “minus words." Table Bl! gives the use of these words. 


The last 35(octal) of the minus words (words 173 to 230) are copied 
into SCM along with the PP. 


Table B1. Problem-program minus words as they reside in LCM. 


0 System 10D: 4 words. 
4 Number (of unprocessed I0D’s); unprocessed 10D‘s: 16 words. 
25 Number of issued IOD’s; number of CFIELD IOD’s: 16 words. 
45 Input/output connectors; 16 10C’s, three words per J10C: 48 words. 
125 Exchange-jump package pool: 8 words. 
135 Word zero first interrupt. 
136 Arithmetic exchange jump package: 16 words. 
156 Problem-program fatal error (high-order 12 bits) and location 
(low-order 48 bits). 
157 Problem-program input/output charge (cycles). 
160 Input/output cycles used. 
161 PPU input/output charge (microseconds). 
162 Total SCM charge (microseconds). 
163 Adjust field length memory charge. 
164 Classification. 
165 Memory charge (microseconds). 
166 1/0 idle clock. 
167 Accumulating total rea! CPU time (microseconds) logged for this PP. 
170 Accumulating total real 1/0 time (microseconds) logged for this PP. 
171 Controller interrupt. 
172 Accumulating total system-cal] time. 
173 Time interrupt. 
174 Mask for recovering contro! after a hardware error (see Sec. 6.4). 
175 Subroutine exchange package information. 
176 LCM slot time. 
177 Accumulating system call time. 
200 Accumulating LCM time. 
201 SCM slot time. 
202 Accumulating system call time. 
203 Accumulating SCM time. 
204 Static memory word (see Appendix D). 
205 Date last accounting. 
206 Seventeenth word. 
207 Eighteenth word. 
210 Executing exchange jump package: 16 words. 
230 Word zero of PP. 
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APPENDIX C: 


INPUT/OUTPUT CONNECTOR (IOC) FORMAT 


As input/output connector is the interface between a problem program 
and the 1/0 device it references. The PP’s minus words (see Appendix B) 
contain sixteen 3-word I0C’s, numbered 0 through 15. I0C O begins at 


minus word 45(octal). 


An 10C is filled in by the system on a Create or 


Open system call; an JOC is cleared by the system on a Close or Destroy 


system call. 


An 10C has the following format (binary): 


aaaaaaaaaaaa aaaaaaaaaaaa aaaaaaaaaaaa aaaaaaaaaaaa aaaaaaaaaaaa 
bbbbbbbbbbbb bbbbbbbbbbbb bbbbbbecccce ececccecccee eceeceececece 
deeeeefffegeg hhhhhhhhhhhh iiijjjkkk!!1! 11111 1 mmmmm mmmmmmmmmmmmn 
where: aa...a is the right-adjusted name of the 1/0 device. Ten 
(60 bits) characters maximum are allowed for a disk file, six 
characters for a tape. 
bb...b is the first-word address (given as a sector 
(30 bits) address) of a disk file (blank if the I/O device 
is a tape), including the 512-word ID sector. 
cc...¢c is the number of words in a disk file (blank if the 
(30 bits) 1/0 device is a tape), including the 512-word ID 
sector. 
d is the public fite bit: 
d=0 Private file. 
d= 1 Public file. 
eeeee is the logical 1/0 unit number. 
eeeee = 1 to 14(octal) Disk. 
eeeee = 11(octal) Drum. 
eeeee = 12(octal) dd80A. 
eevee = 14(octal) Tape. 
eeeee = 15(octal) PDP-10. 
eeeee = 24(octal) Card reader. 
eeeee = 25(octal) Printer. 
fff is the pocl-file flag: 
fff = 0 Not a pool file. 
fff = 1 Pool file. 
eee is the type of 1/0 unit: 
ggg = 0 Disk. 
geg = 1 Tape. 
uee = 3 ddBOA. 
ggg = 7 Drum. 
hh...h is a pointer to the file-entry index (for disk 
(12 bits) 10C’s), or the tape unit designator (for tape 


10C’s). The h field is void for other [0C’s. 
Tape 10C Tape unit, in the for —--—--xxxnnn, 
where xxx is the tape bank (0 or 1) 
and nnn is the tape number (0 to 7). 
Disk 10C Pointer to the file-index entry; al] 
12 bits may be used. 
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jj 
kkk 
l}...1 
(9 bits) 
mm. ..m 
(18 bits) 


is the type of disk file: 


iii 
iii 
iii 
iii 


1 
2 
3 
4 


Read-write. 
Read-only. 
Data. 
Execute-only. 


is the protection level: 


jjj 
iii 
Vid 
Vii 
iii 
jij 
jij 
jij 


NOL WMO 


Not classified. 
Unclassified. 


Protect as restricted data. 
ADP or official use only. 


(Reserved. ) 
Secret. 
(Reserved. ) 
System. 


is the access flag: 


Read access denied. 
Write access denied. 


File is of lower protection level 


problem program. 


is the descriptor block pointer. 


is the count of I/O references. 
increments this field by one. 


request 
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Each 1/0 


than 


APPENDIX D: STATIC MEMORY CONVENTION 
A problem program may be organized in such a way that a portion of its 
image is unchanged by computation. This read-only portion does not need to 
be copied from SCM to LCM. This convention results in a savings of 
block-copy time. 
To use the state memory convention, set up minus word 230(octal) 
(i.e., RAL-24) in the format: 


0000x xxxxx 0000y yyyyy 
where: x is the beginning address of the read-only portion. 
y is the beginning address of the second section of the 
read-write portion. 
The addresses x and y are checked for bounds fault on an end-of-load 
is out-of~bounds, a fatal error 231 results. 


If either 
it specifies that the entire problem 


from disk. 
If minus word 204 is zero, 
program image is to be copied from SCM to LCM. 
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APPENDIX E: CPU EXCHANGE PACKAGE 
AND PROGRAM STATUS DESIGNATOR REGISTER (PSD) 


Figure El and Table E1 show the formats of a problem program’s CPU exchange 
package and of the PSD register. 


SCM location n 


Pig. El. CPU exchange package. 
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Table El. The program status designator (PSD) register. 


Condition flags: 


KOOONOUTARWNHO 


— 


Mode flags: 


Program status 


Under f low 

Overf low 
Indefinite 

Step 

Breakpoint 
Program range 
SCM direct range 
LCM direct range 
SCM block range 
LCM block range 
SCM parity 

LCM parity 


Under f low 
C erflow 
Indefinite 
Step 
Monitor 
Exit 
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APPENDIX F: PROBLEM—PROGRAM STATE CODES 


Problem-program states are often defined by 3-letter codes rather than 
numbers. The correlation between codes and state numbers is as shown in 


Table Fi. 
Table F1. Problem-program state codes. 
State Code Meaning 
11 MEM Waiting for LCM space. 
12 TPE Waiting for tape assignment. 
14 XMT Waiting to send a message to teletypewriter. 
15 WDB Waiting for a free descriptor btock. 
16 RCV Waiting to receive a message from controller. 
22 22 Waiting to send a message to RJET. 
23 23 Waiting to get a message from RJET. 
31 SUS Suspended at program’s own request. 
32 PDP Waiting for a file-transport message packet 
from PDP-10. 
44 4A Waiting to send a message to the PDP-10. 
46 46 Waiting to ser. a message to the operator’s 
teletypewriter. 
56 56 Waiting for controller to process TTY interrupt. 
70-77 FIN Program execution finished. 
1-10 RUN Program in in LCM. 
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NOTICE 


“This report was prepared as an account of work 
sponsored by the United States Government. Neither 
the United States nor the United States Energy 
Research & Development Administration, nor any 
of their employees, nor any of their contractors, 
subcontractors, or their employees, makes any 
warranty, express or implied, or assumes any legal 
liability or responsibility for the accuracy, 
completeness or usefulness of any information, 
apparatus, product or process disclosed, or 
represents that its use would not infringe 
privately-owned rights.”’ 
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